home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / gt1706_4.zip / GT17HOST.DOC < prev    next >
Text File  |  1992-07-10  |  185KB  |  3,777 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                 GT POWER - 17.06
  14.                   Copyright (c) 1985, 1992: by P&M Software Co.
  15.                             All rights are reserved.
  16.  
  17.  
  18.  
  19.                  Host Mode Documentation
  20.  
  21.  
  22.                   June 26, 1992
  23.  
  24.  
  25.  
  26.  
  27.                  P & M Software Company
  28.                  3104 E. Camelback Rd. #503
  29.                  Phoenix, AZ      85016
  30.                  U. S. A.
  31.  
  32.  
  33.  
  34.                  Voice Phone: (602) 897-9557
  35.                  Modem Phone: (602) 897-9549
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                     - 1 -
  60.  
  61.                  Table Of Contents
  62.  
  63.      A Brief Summary . . . . . . . . . . . . . . . . . . . . . . .  4
  64.      The Installation Of Host Mode . . . . . . . . . . . . . . . .  4
  65.      The Modem Init String . . . . . . . . . . . . . . . . . .  4
  66.      The Host Mode: Modem Init String  . . . . . . . . . . . .  4
  67.      The Modem Answer String . . . . . . . . . . . . . . . . .  5
  68.      The Modem Result Codes  . . . . . . . . . . . . . . . . .  5
  69.      Logging Status During Host Mode . . . . . . . . . . . . .  6
  70.      Hang-up During Host Mode  . . . . . . . . . . . . . . . .  6
  71.      The BBS/CBS Path  . . . . . . . . . . . . . . . . . . . .  6
  72.      The Default Message Base Path . . . . . . . . . . . . . .  7
  73.      The Default File Section  . . . . . . . . . . . . . . . .  7
  74.      File Reception Directory  . . . . . . . . . . . . . . . .  7
  75.      The Sysop Message Base  . . . . . . . . . . . . . . . . .  7
  76.      Security Considerations . . . . . . . . . . . . . . . . . . .  7
  77.      DSZ.EXE, PCKERMIT.EXE and Other Externals . . . . . . . .  9
  78.      Host Mode Text Files  . . . . . . . . . . . . . . . . . . . . 12
  79.      Forcing a "More?" Prompt  . . . . . . . . . . . . . . . . 12
  80.      Disable the "More?" Prompt  . . . . . . . . . . . . . . . 12
  81.      Nest the Display of Bulletins . . . . . . . . . . . . . . 12
  82.      Disable the ^K/^C Break . . . . . . . . . . . . . . . . . 12
  83.      ANSI Graphics (.BBS vs .CBS)  . . . . . . . . . . . . . . 12
  84.      The Variable Substitution Line  . . . . . . . . . . . . . 12
  85.      File Descriptions . . . . . . . . . . . . . . . . . . . . . . 14
  86.      GTSYSID.BBS . . . . . . . . . . . . . . . . . . . . . . . 14
  87.      GTWELCOM.BBS  . . . . . . . . . . . . . . . . . . . . . . 14
  88.      GTPASSWD.BBS  . . . . . . . . . . . . . . . . . . . . . . 14
  89.          Field Descriptions  . . . . . . . . . . . . . . . . . 14
  90.          Time Bank Setup . . . . . . . . . . . . . . . . . 16
  91.          Carbon Copy Messages  . . . . . . . . . . . . . . 17
  92.          Callback Setup  . . . . . . . . . . . . . . . . . 19
  93.          GTPASSWD Comment Entries  . . . . . . . . . . . . . . 20
  94.      GTBULLET.BBS  . . . . . . . . . . . . . . . . . . . . . . 20
  95.      BULLETx.BBS . . . . . . . . . . . . . . . . . . . . . . . 20
  96.      GTMENU.BBS  . . . . . . . . . . . . . . . . . . . . . . . 21
  97.      GTHELP.BBS  . . . . . . . . . . . . . . . . . . . . . . . 21
  98.      GTBYE.BBS . . . . . . . . . . . . . . . . . . . . . . . . 21
  99.      GTBYEx.BBS  . . . . . . . . . . . . . . . . . . . . . . . 21
  100.      GTUSER.BBS  . . . . . . . . . . . . . . . . . . . . . . . 21
  101.      GTDIR.BBS . . . . . . . . . . . . . . . . . . . . . . . . 22
  102.          Group Header Lines  . . . . . . . . . . . . . . . . . 22
  103.          Comment Lines . . . . . . . . . . . . . . . . . . . . 22
  104.          Directory Lines . . . . . . . . . . . . . . . . . . . 22
  105.          CD-ROM Support  . . . . . . . . . . . . . . . . . 22
  106.      GTUDIR.BBS  . . . . . . . . . . . . . . . . . . . . . . . 23
  107.      GTLDIR.BBS  . . . . . . . . . . . . . . . . . . . . . . . 24
  108.          Multi-Language Support  . . . . . . . . . . . . . . . 24
  109.          GTANSI.BBS  . . . . . . . . . . . . . . . . . . . . . 25
  110.      GTDDIR.BBS  . . . . . . . . . . . . . . . . . . . . . . . 25
  111.      GTBMENU.BBS . . . . . . . . . . . . . . . . . . . . . . . 26
  112.      GTMDIR.BBS  . . . . . . . . . . . . . . . . . . . . . . . 27
  113.          Grouping Areas  . . . . . . . . . . . . . . . . . . . 28
  114.      GTDOORS.BBS . . . . . . . . . . . . . . . . . . . . . . . 29
  115.          GTDOORnn.BAT and GTDORnnn.BAT . . . . . . . . . . . . 29
  116.  
  117.  
  118.                     - 2 -
  119.  
  120.      ANSWERn.BBS . . . . . . . . . . . . . . . . . . . . . . . 30
  121.      QUESTn.BBS  . . . . . . . . . . . . . . . . . . . . . . . 31
  122.          New Caller Questionnaire  . . . . . . . . . . . . . . 31
  123.          Programmable Questionnaires . . . . . . . . . . . . . 32
  124.      PQUESTn.BBS . . . . . . . . . . . . . . . . . . . . . . . 35
  125.      GTQMENU.BBS . . . . . . . . . . . . . . . . . . . . . . . 36
  126.      PROTOCOL.BBS  . . . . . . . . . . . . . . . . . . . . . . 36
  127.      GT_VSCAN.BAT  . . . . . . . . . . . . . . . . . . . . . . 37
  128.          Virus Scan Setup  . . . . . . . . . . . . . . . . . . 37
  129.      WELCOME.BBS . . . . . . . . . . . . . . . . . . . . . . . 38
  130.      MBULLETx.BBS  . . . . . . . . . . . . . . . . . . . . . . 38
  131.      SYSOP.BBS . . . . . . . . . . . . . . . . . . . . . . . . 38
  132.      SCHEDULE.BBS  . . . . . . . . . . . . . . . . . . . . . . 41
  133.      TRASHCAN.BBS  . . . . . . . . . . . . . . . . . . . . . . 42
  134.      FILES.BBS . . . . . . . . . . . . . . . . . . . . . . . . 43
  135.      Host Mode Control Files and Directories . . . . . . . . . . . 44
  136.      Running Host Mode . . . . . . . . . . . . . . . . . . . . . . 46
  137.      SYSOP Commands  . . . . . . . . . . . . . . . . . . . . . 46
  138.      Command Line Usage  . . . . . . . . . . . . . . . . . . . 46
  139.      The HOST.BAT File . . . . . . . . . . . . . . . . . . . . 49
  140.      The HOST.SCR File . . . . . . . . . . . . . . . . . . . . 49
  141.      Full Screen Message Edit  . . . . . . . . . . . . . . . . 49
  142.      Caller Expiration Dates . . . . . . . . . . . . . . . . . 49
  143.          XWARNING.BBS  . . . . . . . . . . . . . . . . . . . . 49
  144.          EXPIRED.BBS . . . . . . . . . . . . . . . . . . . . . 49
  145.      Using a LAN with GT . . . . . . . . . . . . . . . . . . . 50
  146.          The CB Simulator  . . . . . . . . . . . . . . . . . . 51
  147.      The Host Mode LOG . . . . . . . . . . . . . . . . . . . . . . 54
  148.      File Tagging  . . . . . . . . . . . . . . . . . . . . . . . . 55
  149.      TAGWARN.BBS . . . . . . . . . . . . . . . . . . . . . . . 55
  150.      Binary Message Upload . . . . . . . . . . . . . . . . . . . . 56
  151.      The Shell to DOS  . . . . . . . . . . . . . . . . . . . . . . 57
  152.      COMMAND.COM . . . . . . . . . . . . . . . . . . . . . . . 57
  153.      DOS 2.xx  . . . . . . . . . . . . . . . . . . . . . . . . 57
  154.      Using the Shell to DOS  . . . . . . . . . . . . . . . . . . . 58
  155.      The Usage of Color  . . . . . . . . . . . . . . . . . . . . . 59
  156.      The Logon Doors . . . . . . . . . . . . . . . . . . . . . . . 59
  157.      GTLOGON.BAT . . . . . . . . . . . . . . . . . . . . . . . 59
  158.      GTNLOGON.BAT  . . . . . . . . . . . . . . . . . . . . . . 60
  159.      BPLOGON.BAT . . . . . . . . . . . . . . . . . . . . . . . 60
  160.      The Logoff Doors  . . . . . . . . . . . . . . . . . . . . . . 60
  161.      GTLOGOFF.BAT  . . . . . . . . . . . . . . . . . . . . . . 60
  162.      GTNLOGOF.BAT  . . . . . . . . . . . . . . . . . . . . . . 60
  163.      Appendix  . . . . . . . . . . . . . . . . . . . . . . . . . . 61
  164.      Extended ASCII Codes  . . . . . . . . . . . . . . . . . . 61
  165.      Sample ANSI Sequences . . . . . . . . . . . . . . . . . . 61
  166.      Power-Loss Protected Operation  . . . . . . . . . . . . . 62
  167.      Sample Files For Power-Loss Protected Operation . . . . . 63
  168.      GT POWER under DESQview . . . . . . . . . . . . . . . . . 64
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.                     - 3 -
  178.  
  179.  
  180.      Brief Summary
  181.      -------------
  182.      The host mode provided within GT POWER allows you to run an unattended
  183.      session with your system.  That is,  if you expect  to  receive  calls
  184.      from  other  computer systems (say from clients or a set of authorized
  185.      remote users) then you can tell GT POWER that it should  automatically
  186.      answer the telephone for you,  verify the caller's credentials, and if
  187.      found to be valid,  to provide that user with a menu of functions that
  188.      can   be  performed.   All  of  that,   of  course,   without  further
  189.      intervention on your part.
  190.  
  191.      Security is of paramount importance when  running  in  host  mode  for
  192.      obvious   reasons.   Please   read   the  section  entitled  'Security
  193.      Considerations' before attempting to operate this system.
  194.  
  195.      Installation of Host Mode
  196.      -------------------------
  197.      The most important thing about host mode is proper installation of the
  198.      modem  control strings and result codes.  These strings and codes must
  199.      not just control the modem, they MUST WORK TOGETHER.  For example,  if
  200.      the modem init strings specify "verbose" result codes, then the result
  201.      code  table  better  have  the  "verbose"  codes  in it.  There are 11
  202.      specific areas that must  be  installed;  all  of  these  options  and
  203.      strings  are  accessible via the ALT-I command.  Let's discuss each of
  204.      these items in turn:
  205.  
  206.      1.   The "Modem Init String".  The default value is:
  207.  
  208.                AT V1 Q0 E0 X1 S0=0 S2=43|
  209.  
  210.       Assuming that one wants to  use  the  default  string,  there  is
  211.       really  only one thing that one SHOULD DO to this string:  change
  212.       the Xn command.  The most powerful Xn command available  on  your
  213.       modem  is  the  one  to  choose.  With  a USRobotics Courier 2400
  214.       modem,  use either X5 or X6.  With a normal Hayes-compatible 1200
  215.       baud modem, use X1.  X4 would be normal for most Hayes-compatible
  216.       2400 baud modems.  For other modems consult the modem manual.
  217.  
  218.       Despite the advice given above,  many  situations  call  for  the
  219.       modem to use a lower Xn setting.  For example dial tone detection
  220.       logic can sometimes be bothersome,  ditto for the voice detection
  221.       logic... the solution is to set the lowest Xn value that supports
  222.       busy detection (which is very helpful).
  223.  
  224.       NOTE:
  225.            Many  so  called  "Hayes-compatibles" are compatible in name
  226.            only.  We get many calls for support from  individuals  with
  227.            non-Hayes  modems.  Please  read your modem manual carefully
  228.            because it is very hard to support all the different modems.
  229.  
  230.      2.   The "Host Mode:  Modem Init String".  This string is found  under
  231.       item #30 of the configuration screen.  The default value is:
  232.  
  233.                AT V1 Q0 E0 M0 X1 S0=0 S2=255|
  234.  
  235.  
  236.                     - 4 -
  237.  
  238.  
  239.       There are several things one could do to this string.  First, one
  240.           must modify the X1 command to match the value added to the  Modem 
  241.           Init  String  above.  Secondly,  if one desires the speaker to be 
  242.           heard during host mode,  remove the M0 from the string.  Thirdly, 
  243.           the  S0=0  may  be changed to S0=1,  THIS IS THE ONLY OTHER VALID 
  244.           VALUE!  If S0=1 is used,  the modem  will  answer  automatically, 
  245.           otherwise  GT·POWER will count the rings and command the modem to 
  246.           answer after the 2nd ring (or if the /Rn command line  switch  is 
  247.           used,  after  the  Nth  ring).  This is why S0=0 and S0=1 are the 
  248.           only permissible values!  In any case,  the S0  setting  must  be 
  249.           lower  than  the /Rn setting.  Refer to the GT1706.DOC file for a 
  250.           complete discussion of the available command line switches.  
  251.  
  252.      3.   The  "Modem Answer String".  This string is located with the Host 
  253.           Modem Init String under item #30  of  the  configuration  screen.  
  254.       The default value is:
  255.  
  256.                            ATA|
  257.  
  258.       GT POWER  will  issue  this string to the modem whenever the ring
  259.           count reaches 2 (or the number  indicated  by  the  /Rn  switch).  
  260.           This string should not be changed,  unless GT POWER should not be 
  261.           allowed to answer the modem.  For example,  one could erase  this 
  262.           string  and  set S0=5,  so that the modem would answer on the 5th 
  263.           ring, but I don't advise anyone do this.  
  264.  
  265.      4.   The "Result Codes".  Because the modem init strings above contain 
  266.           V1,  "verbose" result codes should be  programmed.  They  can  be 
  267.           found  under  item #29 of the configuration screen.  There are 19 
  268.           possible results.  If the modem does not support  all  of  these, 
  269.           simply  leave  the  extra  strings  in  their default state.  The 
  270.           program comes with the default result codes set for  use  with  a 
  271.           USRobotics  Courier HST modem.  Please consult the manual for the 
  272.           modem in use and modify this table to match.  Remember,  use  the 
  273.           "verbose" (word codes), not the "terse" codes.  It IS POSSIBLE to 
  274.       use  the "terse" codes,  but they are not as compatible with such
  275.       services as PC Pursuit.
  276.  
  277.       If one of the newer high speed  modems  is  in  use,  such  as  a
  278.       v.32/v.42 type, it is most likely that the modem has more CONNECT
  279.           type  result  codes than GT POWER has space in its table.  To get 
  280.           around this problem,  and  avoid  the  necessity  of  continually 
  281.           expanding  the  result  code  table,  GT POWER will automatically 
  282.           recognize CONNECT messages that  match  the  standard  form.  For 
  283.       example:
  284.  
  285.                 CONNECT 9600/REL
  286.  
  287.       This  code  is  not  one  of the default codes in the table,  but
  288.       GT POWER will recognize it, since it matches the standard form:
  289.  
  290.                (1) The word CONNECT, followed by
  291.                (2) The DCE baud rate, followed by
  292.                (3) The error correction indicator.
  293.  
  294.  
  295.                     - 5 -
  296.  
  297.  
  298.           GT POWER will automatically recognize this and  take  the  proper 
  299.           action.  To  enable  this  smart result code handling,  the modem 
  300.           must be setup to return "verbose" codes.  
  301.  
  302.      5.   It  is  highly recommended that logging be TRUE during host mode.  
  303.           Otherwise,  all records of  the  host  mode  activities  will  be 
  304.           discarded.  
  305.  
  306.      6.   How to allow GT POWER to hang-up  during  host  mode.  Since  the 
  307.           "escape  code" must be disabled during host mode,  otherwise some 
  308.           caller  may  crash  your  system,   the  normal  hang-up  string, 
  309.           "~+++~ATH",  will  not work!  Therefore,  GT POWER cannot hang-up 
  310.           the modem,  unless you set the modem  to  normal  DTR  operation.  
  311.           During  host mode,  GT POWER will drop the DTR signal whenever it 
  312.           wants the modem to hang-up.  Most modems come  from  the  factory 
  313.           set  so that they ignore the DTR signal - you must reset a switch 
  314.       or,  in the case of the Hayes 2400 modem,  you must make an entry
  315.           in  the Modem init string to do this.  In any case,  if the modem 
  316.           ignores DTR,  it will not hang up during  host  mode  operations.  
  317.       Some  modems  which  must be setup via the init strings to handle
  318.           DTR properly use either &D2 or &D3, please consult the manual for 
  319.           the modem in use to determine the correct setting.  
  320.  
  321.      7.   How  does  GT POWER  determine  when  a  connection is lost?  The 
  322.           GT POWER host monitors the carrier detect signal from the  modem, 
  323.           when  this  signal  goes  low,  then  GT POWER  assumes  that the 
  324.           connection has been lost.  Most modems come from the manufacturer 
  325.           with the carrier detect signal forced high.  "This is like having 
  326.           a  telephone  with no ringer." Quote by Tom Jennings.  Obviously, 
  327.           this must be changed.  Some modems have a  switch  that  must  be 
  328.           reset  to enable a true carrier detect,  others require setup via 
  329.           the init string.  Many of the modems  that  require  init  string 
  330.           setup  use '&C1',  please consult the manual for the modem in use 
  331.           to determine the correct setting.  
  332.  
  333.      8.   If this path is set,  GT POWER will search that path for  BBS/CBS 
  334.       files.  GT POWER  will  also  search the GTPATH directory for the
  335.           files.  The GTPATH directory is search first,  then  the  BBS/CBS 
  336.           path.  This  feature will be of great interest to LAN users,  who 
  337.       are advised to become familiar  with  the  DOS  "subst"  command,
  338.           which will allow GTMDIR.BBS and GTDIR.BBS to be the same across a 
  339.           LAN.  Here is a sample of the "subst" command: 
  340.  
  341.                                  subst  e:  c:\
  342.  
  343.           If this command were invoked in the AUTOEXEC.BAT file on your LAN 
  344.           server,  then all references to drive E:  on the server would  be 
  345.           translated  to  drive  C.  This would be extremely helpful if the 
  346.           LAN workstations mapped the server's drive  C  to  E  also.  This 
  347.           would  mean  that both workstation and server could reference the 
  348.           same physical drive with the same drive letter, i.e. E.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.                     - 6 -
  355.  
  356.  
  357.       It is possible to also use the BBS/CBS path for  the  door  batch
  358.       files, but it would be wise for LAN operators to make these files
  359.       Read-Only,  otherwise  they  can cause a SHARE violation,  as DOS
  360.           does not open them in a  shared  read  mode.  The  following  DOS 
  361.           command can be used to make batch files Read-Only: 
  362.         
  363.                                  attrib +r *.bat
  364.  
  365.           Assuming, of course, that the batch files to be altered are in
  366.           the current default directory.
  367.          
  368.      9.   Another option available under the Alt-I, #26, the pathname setup 
  369.           section,  is the "Default Message Base PATH".  This option is  to 
  370.           be used to indicate to GT POWER where the main or default message 
  371.           base  is located.  This is the message base that the user will be 
  372.           initially given access to upon calling the  system.  This  should 
  373.           be an open message base since all callers to the system that pass 
  374.           the logon procedure will have access to this area.  
  375.  
  376.      10.  Another option available under the Alt-I, #26, the pathname setup 
  377.           section, it the "Default File Section".  This option indicates to 
  378.           GT POWER where the main or default file section is located.  This 
  379.           is  the  file  section  that callers will see initially when they 
  380.           access your system.  This should  be  an  area  with  the  lowest 
  381.           security access level, so everyone will be able to use it.  
  382.  
  383.      11.  To designate the directory where the host  mode  receives  files, 
  384.           you  should  specify the DOWNLOAD directory path.  This option is 
  385.           specified under Alt-I, #26,  the pathname setup section.  You may 
  386.           be  confused  by the terminology here,  so let me stress that the 
  387.           DOWNLOAD directory is where GT POWER *RECEIVES* files, whether in 
  388.           host or terminal modes.  Further,  the UPLOAD directory path only 
  389.           pertains  to  Terminal  Mode,  as  the  host  mode file areas are 
  390.           controlled via entries in the GTDIR.BBS file, described below.  
  391.  
  392.      12.  To specify the directory where the host mode will  save  messages 
  393.           to  the  sysop.  These  messages are entered with the 'M' command 
  394.           from the main menu.  This option is specified under  Alt-I,  #26, 
  395.           the pathname setup section.  
  396.  
  397.  
  398.      PLEASE NOTE:
  399.           The pathnames mentioned above are all found on the pathname setup 
  400.           section, #26 of the Alt-I menu.  
  401.  
  402.  
  403.      Security Considerations
  404.      -----------------------
  405.      Many  of  GT POWER's  design  considerations  were  directed   towards 
  406.      providing  absolute system integrity while in host mode.  This section 
  407.      is designed  to  highlight  some  of  those  considerations  with  the 
  408.      intention  of making the System operator of a host mode fully aware of 
  409.      both his protection and his responsibilities in that regard.  
  410.  
  411.  
  412.  
  413.                                     - 7 -
  414.  
  415.  
  416.      The fundamental truth about security is that essentially  it  is  YOUR 
  417.      responsibility.  GT POWER's  first  line  of defense in your behalf is 
  418.      its password function.  Without  a  pre-assigned  password,  a  remote 
  419.      caller  cannot  gain  access  to  the  functions provided by GT POWER!  
  420.      Thus,  it stands to reason that your first responsibility is to assign 
  421.      those  passwords and TO GUARD THEM.  Because there are several sets of 
  422.      facilities that you will wish to control and to allow various users to 
  423.      be  provided  selectively,   GT POWER  provides  several  'levels'  of 
  424.      authorization that may be assigned to each password.  In this way, all 
  425.      users  who log on with the same password will have identical (and only 
  426.      those  that  are  assigned)  access  to  GT POWER's  facilities.   For 
  427.      example, GT POWER provides to users who have a sufficiently high level 
  428.      of authorization, the ability to shell to DOS, and have the ability to 
  429.      execute  ANY  DOS COMMAND from their remote location!  Obviously,  you 
  430.      would  not  casually  distribute  that  password  amongst  your   user 
  431.      community.  Most  users  should  NEVER  be  allowed  to  shell to DOS!  
  432.      (While in DOS a user could, for example,  format your hard disk - that 
  433.      would, of course, result in the end of subsequent functionality of the 
  434.      entire  system).  To  most  users  you  should assign a lower level of 
  435.      access.  The SYSOP.EXE program can be used to change most items  in  a 
  436.      caller's  user  record -- especially the access level may be raised or 
  437.      lowered, as necessary.  
  438.  
  439.      One  of  the  nicest features of the host mode provided by GT POWER is 
  440.      its message bases.  With this feature the  users  of  the  system  may 
  441.      leave  mail  for other users and receive mail for themselves.  Indeed, 
  442.      there are two kinds of mail:  Public and Private.  Public mail may  be 
  443.      read by any user of the system.  Private mail,  on the other hand, may 
  444.      be read only by the person sending  it  or  by  the  recipient.  Here, 
  445.      then,  is  another  area  of security that you need to be aware of and 
  446.      control.  For example,  say that you allow your system to be called by 
  447.      clients of your firm and that they are encouraged to leave messages to 
  448.      you  in your absence.  It is possible that several of your clients are 
  449.      competitors of each other.  Thus,  it would be improper to allow  them 
  450.      to read messages sent by others.  This is the reason for Private mail.  
  451.      At  this point,  I would like to point out that there is no such thing 
  452.      as 'Private' from the Sysop!  That is, the Sysop may read any message, 
  453.      whether addressed to the Sysop or not  and  whether  they  are  marked 
  454.      Private or not.  Finally, in case the earlier remarks did not sink in, 
  455.      any  user  who has access to the DOS via the Shell command (because of 
  456.      his assigned extremely high 'level' of authorization) can easily  read 
  457.      any messages while he is in the DOS Shell!  
  458.  
  459.      As  far  as  sending  Private  messages  to  the  System  operator  is 
  460.      concerned,  any user may do that!  There is an 'M' command on the Main 
  461.      Menu that results in messages that only  the  Sysop  may  view.  These 
  462.      messages  are  automatically  addressed  to  the  Sysop  and marked as 
  463.      private.  They are placed in the  message  base  specified  for  sysop 
  464.      messages,   they   may   be  read  only  by  someone  with  the  Sysop 
  465.      authorization level.  This message base needs to be accessed at  least 
  466.      once by the sysop during setup, to insure that a message is entered to 
  467.      create  all control files.  Otherwise,  the system will not be able to 
  468.      process 'M' messages to the sysop.  
  469.  
  470.  
  471.  
  472.                                     - 8 -
  473.  
  474.  
  475.      The  hierarchy  of access 'levels' based on password enables the Sysop 
  476.      to control which directories on the disk those users  have  access  to 
  477.      for purposes of downloading files.  However, each caller to the system 
  478.      will  be  granted  access  to  the "Default file section",  which is a 
  479.      configuration option.  So  please  be  sure  that  this  file  section 
  480.      contains the least sensitive material on your system.  
  481.  
  482.      For ease of use,  it is recommended that the user  construct  a  batch 
  483.      file  to invoke GT POWER,  especially host mode users.  It should look 
  484.      like this: 
  485.  
  486.             C:                              To specify a default drive of C
  487.             set GTPATH=C:\GT                Remember to set GTPATH!
  488.             GT1706 host.scr                 To invoke GT POWER
  489.  
  490.      If the above batch file were called GT.BAT and placed in your system's 
  491.      PATH  then you could easily invoke GT POWER by simply typing:  GT.  It 
  492.      is important to note, that one of the most frequent errors reported to 
  493.      the GT POWER support staff is the incorrect setting of GTPATH.  The 
  494.      file 'host.scr', named on the GT1706 command line above, is an ASCII 
  495.      text file that contains a single entry:
  496.  
  497.                                       host
  498.  
  499.      The 'host.scr' file can be easily created with a text editor,  such as 
  500.      EDLIN, EDIT or QEDIT, and it should be placed in the script directory, 
  501.      which is named under the Pathnames option on the Alt-I screen.  
  502.  
  503.      As you will see when you read the next section  (about  the  GTDIR.BBS 
  504.      file), you can allow your users to have access to all directories that 
  505.      have  a  matching  authorization  level  OR  LOWER.  Further,  you can 
  506.      specify that particular directories are  only  available  to  specific 
  507.      authorization levels.  
  508.  
  509.      Where is all this authorization  level  information  kept  within  the 
  510.      GT POWER system?  In a file called GTPASSWD.BBS.  That file is the key 
  511.      to  the  security of your system.  One of the subtle security features 
  512.      of GT POWER is that it will  not  allow  that  file,  even  if  it  is 
  513.      contained in a directory that the user has been authorized to download 
  514.      from, to be transmitted over the telephone!  
  515.  
  516.      NOTE:  That  the  external protocols can transfer prohibited files and 
  517.             for this reason, extreme care should be taken when using either 
  518.             DSZ.EXE or PCKERMIT.EXE.  
  519.  
  520.      Similarly,  because  the  log  file  that  is optionally maintained by 
  521.      GT POWER contains the user names  and  passwords  of  those  who  have 
  522.      logged  onto the system,  it may not be transmitted over the telephone 
  523.      either.  
  524.  
  525.      When  running  in  host  mode  the screen on the host system shows all 
  526.      keystrokes entered by the remote user (except while he is in  the  DOS 
  527.      Shell  or  using  a  DOOR).  In other words,  if the remote user,  for 
  528.      example,  entered a Private message to another user,  or to the Sysop, 
  529.  
  530.  
  531.                                     - 9 -
  532.  
  533.  
  534.      the  text  is  showing on the host screen as it is typed.  If the user 
  535.      were to log off immediately after entering the message then  it  would 
  536.      be  possible  that  the  text  of  the message remained on the screen.  
  537.      GT POWER erases the screen after the caller hangs up to prevent such a 
  538.      lapse in security.  If you are  running  a  host  mode  system  in  an 
  539.      environment  where  others might be able to observe the screen then it 
  540.      is recommended that you turn your monitor off while  you  are  not  in 
  541.      attendance.  
  542.  
  543.      If  others may be in the area as you are communicating (chatting) with 
  544.      users and you wish to control the information on the screen you  would 
  545.      do  well  to  remember that the Alt-W keystroke will erase your screen 
  546.      instantly.  
  547.  
  548.      A user may be bannned from accessing the system.  Note,  however, that 
  549.      doing so merely encourages an undesirable to log on with another  user 
  550.      name.  With  the advent of personalized passwords,  this provision has 
  551.      become more effective,  since one could setup the system  password  to 
  552.      have a low access level, which would be raised only after validation.  
  553.  
  554.      Computer  time  is  a resource that you can also control in host mode.  
  555.      Each password may have a designated time limit beyond which the caller 
  556.      will be automatically logged off.  The number of calls per day made to 
  557.      your system by an individual caller is also subject to control.  
  558.  
  559.      One  of  the  more  subtle  security  measures  needed  in a host mode 
  560.      ennvironment is called a 'Watchdog'.  In  the  GT POWER  system,  this 
  561.      function  is  provided  by a program called DOORMAN.  DOORMAN is a TSR 
  562.      program that should be loaded in your AUTOEXEC.BAT  file,  it  has  no 
  563.      command  line  options,  and  is  loaded simply by its name,  DOORMAN.  
  564.      Should an authorized user be in the DOS Shell or in a DOOR, and if for 
  565.      any reason he were to drop his carrier  (hang-up),  the  system  would 
  566.      then  be  vulnerable  to the next caller as that caller could find the 
  567.      system at the DOS prompt and he would then have uncontrolled access to 
  568.      do as he pleased to your system.  In the situation mentioned,  loss of 
  569.      carrier, DOORMAN will force your system to reboot and if you setup the 
  570.      AUTOEXEC.BAT  file  properly,  when  the system completes rebooting it 
  571.      will invoke GT POWER and put it back in  host  mode!  The  same  thing 
  572.      would  happen  if  a  power failure occurs during host mode operation.  
  573.      When power is restored the system will  automatically  return  to  the 
  574.      host mode of GT POWER.  Note,  however, that for those systems that do 
  575.      not have a built in clock,  the time and date of the system  would  no 
  576.      longer be correct.  
  577.  
  578.      As a Sysop of a GT POWER system you must be aware that there are  some 
  579.      legal considerations that you may face.  For example, should you allow 
  580.      users to place copyrighted programs onto your system and to then allow 
  581.      other   users   to   download  those  same  programs,   then  you  are 
  582.      participating in an illegal activity!  Naturally there is  no  way  to 
  583.      prevent a user from sending you copyrighted material,  provided he has 
  584.      upload capability.  There are many things that you can do, however, to 
  585.      stop  others  from  having  access  to  that  material.  For  example, 
  586.      GT POWER  allows  you  to  cause  all  files that are uploaded to your 
  587.      system to be placed into a special receiving  directory,  rather  than 
  588.  
  589.  
  590.                                    - 10 -
  591.  
  592.  
  593.      into  the  directory the user is currently using.  It makes good sense 
  594.      to make a receiving directory PRIVATE,  in the sense that  it  is  NOT 
  595.      listed  as  available  in the GTDIR.BBS to your remote users.  In this 
  596.      way,  you may review the files received at your convenience  and  move 
  597.      them over to the public directories if you are satisfied that they are 
  598.      either public domain or shareware programs and files.  
  599.  
  600.      Another  reason that you will want to do the above is that there are a 
  601.      few people out in the world that like to send what are  called  Trojan 
  602.      Horse programs to BBS's.  A Trojan Horse is a program that causes some 
  603.      form  of  damage  when it is run.  It would not be at all fair to your 
  604.      users to expose them to such programs.  So, when it is safe for you to 
  605.      do so,  run  the  programs  you  receive  before  making  it  publicly 
  606.      available  (using  BOMBSQAD  or a similar program to prevent a problem 
  607.      for you).  When you are satisfied that the programs received are  safe 
  608.      then you can move them to public areas.  
  609.  
  610.      NOTE: Running programs uploaded to a BBS is extremely  dangerous.  And 
  611.            can result is the crash of your system, i.e.  someone may break-
  612.            in,  because you have run what seems to be  a  harmless  upload.  
  613.            Please be carefull!!  
  614.  
  615.      And in the event  that  a  user  does  send  you  a  Trojan  Horse  or 
  616.      copyrighted  code,  it  is  in  your best interest to know who did so.  
  617.      GT POWER provides an optional log file function.  If that is  enabled, 
  618.      which  is  highly  recommended,  then the log contains the name of the 
  619.      person who logged on and sent you the file.  GT POWER  also  puts  the 
  620.      name  of  the  uploader with the file description given at the time of 
  621.      upload.  
  622.  
  623.      This section of the document is substantially larger than you may have 
  624.      expected it to be.  The reason should now be obvious.  
  625.  
  626.      YOU are the person responsible for security.  It is necessary that you 
  627.      know the previous information and take appropriate actions.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.                                    - 11 -
  650.  
  651.  
  652.      Host Mode Text Files
  653.      --------------------
  654.      The following text files must be created  and/or  maintained  with  an 
  655.      editor  that  can  produce plain ASCII files.  Any of the display type 
  656.      BBS files may have a DC2, Ctrl-R,  character inserted into column 1 of 
  657.      line 1 to disable the "More?" prompt during display of the file, and a 
  658.      DC4, Ctrl-T, character inserted into column 1 of line 1 to disable the 
  659.      Ctrl-K and/or Ctrl-C user break,  or a ENQ, Ctrl-E, character inserted 
  660.      into column 1 of any line to force a "More?" pause  at  that  line.  A 
  661.      NAK,  Ctrl-U,  can  be inserted in column 1 of any line to introduce a 
  662.      variable substitution line.  The ACK, Ctrl-F,  can be used in column 1 
  663.      of a bulletin file to nest the display of other text files.  
  664.  
  665.      +--------------------------------------------------------------------+
  666.      |                                                                    |
  667.      |     Ctrl-E ... ENQ ... Insert a "More?" at current location.       |
  668.      |     Ctrl-F ... ACK ... Nest the display of bulletin files.         |
  669.      |     Ctrl-R ... DC2 ... Disable "More?" during file display.        |
  670.      |     Ctrl-T ... DC4 ... Disable ^K/^C break during file display.    |
  671.      |     Ctrl-U ... NAK ... Introduce variable substitution line.       |
  672.      |                                                                    |
  673.      +--------------------------------------------------------------------+
  674.  
  675.      Please  note  that once the Ctrl-E command has been used the automatic 
  676.      insertion of "More?" prompts are terminated for the  duration  of  the 
  677.      current display.  
  678.  
  679.      Using the Ctrl-R to disable the "More?" prompt is useful when the file 
  680.      contains such graphic or annimation techniques that would  be  spoiled 
  681.      by  such  interruption.  Except  for  the  GT?DIR.BBS  files  and  the 
  682.      SYSOP.BBS file,  every .BBS file can have two versions:  (a)  a  color 
  683.      graphics  version  or  (b)  a plain text version.  This is coordinated 
  684.      with the ANSI graphics question asked of callers before they logon the 
  685.      system.  The .BBS extension is the default used if only one version of 
  686.      the file can be found by GT, the .CBS extension is used to indicate to 
  687.      GT POWER that a graphics version is available.  If both  versions  are 
  688.      available,  the  .CBS  version  will  be  shown  to  callers who elect 
  689.      graphics, if graphics are not elected by the caller,  the .BBS version 
  690.      will be displayed.  
  691.  
  692.      The variable substitution line is interpreted by GT POWER, and certain 
  693.      substitutions can be made.  The following are supported: 
  694.  
  695.           A ... The DTE baud rate.
  696.           B ... The DCE baud rate.
  697.           C ... The caller's number (i.e. the 100th caller).
  698.           D ... The current calendar date.
  699.           DL .. Daily download limit, in thousands.
  700.           DT .. Amount downloaded today, in thousands.
  701.           F ... The caller's first name.
  702.           G ... The caller's screen length setting.
  703.           H ... The caller's home - city and state.
  704.           L ... Time left for current session in minutes.
  705.           M ... The current message base description.
  706.  
  707.  
  708.                                    - 12 -
  709.  
  710.  
  711.           N ... The caller's full name.
  712.           R ... The caller's upload amount in kilobytes.
  713.           RF .. The caller's upload amount in number of files.
  714.           S ... The current file section description.
  715.           T ... The current time of day.
  716.           TB .. Current Time Bank total.
  717.           TD .. Time Bank daily deposit limit.
  718.           TW .. Time Bank daily withdrawal limit.
  719.           Wn .. Set width of the parameter that follows to 'n' columns.
  720.           X ... The caller's download amount in kilobytes.
  721.           XF .. The caller's download amount in number of files.
  722.           XD .. Expiration date for caller's account.
  723.           XP .. Number of days past expiration date.
  724.           XU .. Number of days until expiration date.
  725.           XL .. Number of days warning that expiration will be given.
  726.           n ... 'n' number of blank columns.
  727.  
  728.      In addition to these items, plain text may also appear on the variable
  729.      substitution line, it must be quoted however, like this:
  730.  
  731.                 "plain text between quotation marks"
  732.  
  733.           For example:
  734.  
  735.                 ^U"          Name: "N
  736.                 ^U"         First: "F
  737.                 ^U"          Home: "H
  738.                 ^U"Time remaining: "L
  739.                 ^U"  Current time: "T
  740.                 ^U" Blank Columns: "30"30 of them."
  741.                 ^U"   Fixed width: "W30N"30 characters in width"
  742.  
  743.      The  ^U  feature can be used with messages,  as well as with bulletins 
  744.      and other screens.  For example, you can now address a message to: 
  745.  
  746.                                        ^UF
  747.  
  748.      Which,  as  you  guessed,  make all callers think that the message was 
  749.      personally addressed to them!  A fancy way to implement "junk mail" on 
  750.      a bulletin board!  <GRIN> The text of messages  can  also  contain  ^U 
  751.      lines, to further allow customization of messages.  
  752.  
  753.      Everyone  should  restrain  their  usage of the ^U feature in echomail 
  754.      conferences.  In fact, it may be banned from echomail conferences,  if 
  755.      abused.  
  756.  
  757.      The nesting of bulletin files with the Ctrl-F character  is  extremely
  758.      useful,  but also hazzardous, if the nesting is done to a great level.
  759.      For best results,  the nesting should be kept to a  single  level.  An
  760.      example of usage is:
  761.  
  762.                                  ^FC:\GT\FOO.BAR
  763.  
  764.      Please note that there is no space between the Ctrl-F and the filename
  765.  
  766.  
  767.                                    - 13 -
  768.  
  769.  
  770.      and that the full pathname must be given for the file.
  771.  
  772.  
  773.  
  774.      
  775.      File Descriptions
  776.      -----------------
  777.      GTSYSID.BBS     This file is displayed as soon as  the  GT POWER  host 
  778.                      detects  a  connection  has  been  established with an 
  779.                      incoming call.  After displaying this  file,  GT POWER 
  780.                      will  ask the user if the terminal program he is using 
  781.                      supports  ANSI   graphics.   If   a   language   menu, 
  782.                      GTLDIR.BBS, is being used, it will be displayed before 
  783.                      the GTSYSID.BBS 
  784.  
  785.      GTWELCOM.BBS    This  file  is displayed to a caller just before he is 
  786.                      asked for his name by the GT  POWER  host.  It  should 
  787.                      identify the system to callers.  
  788.  
  789.  
  790.      GTPASSWD.BBS    This  file  contains the list of passwords that people 
  791.                      must know  to  access  the  system.  Comments  may  be 
  792.                      placed  in  this  file  by  placing a ';' in the first 
  793.                      column of any line.  The  entries  in  this  file  are 
  794.                      composed  of  one  line  per  password,  and each line 
  795.                      contains  the  following  information,   beginning  in 
  796.                      column 1: 
  797.  
  798.      Lx ([xx:xx(,m/n,hh:mm,path)]) Pwd Auth (1st-Name Last-Name Phone-Number)
  799.  
  800.                      These  items  can  have  a  variable  number of blanks 
  801.                      between them,  but the 'L' must  begin  in  column  1.  
  802.                      EACH  PASSWORD,  "Pwd",  MUST  BE UNIQUE and from 1-20 
  803.                      characters in length.  
  804.  
  805.                      The () which have been  shown  around  the  call  time 
  806.                      limit, the daily call limit, the daily download limit, 
  807.                      the  daily  time  limit,  the  name,  and phone number 
  808.                      fields,  indicate that these items  are  optional  and 
  809.                      need not be included in the file.  
  810.  
  811.              Field descriptions:
  812.              -------------------
  813.              Lx ......... The Access Level assigned to this entry.  May  be 
  814.                           any character from the following sets:  0-9, A-Z, 
  815.                           or a-z.  NOTE:  "0" is the highest level and  "z" 
  816.                           is  the  lowest.  The  'x'  following  'L' is the 
  817.                           bullet number that this  caller  will  be  shown.  
  818.                           Valid   bullet   numbers  are  0-9,   A-Z.   Read 
  819.                           additional instructions bellow under BULLETx.BBS.  
  820.  
  821.              xx:xx ...... The Call Time Limit.  This field is optional  and 
  822.                           is   enclosed  within  [...].   If  omitted,   it 
  823.                           defaults to approximately 24 hours.  
  824.  
  825.  
  826.                                    - 14 -
  827.  
  828.  
  829.  
  830.              m/n ........ The Daily Call Limit/the  Daily  Download  Limit.  
  831.                           This field is a sub-field within the [...] of the 
  832.                           Call  Time  Limit  field.  It cannot be specified 
  833.                           without the Call Time Limit being specified also.  
  834.                           Example:  [1:30,2] would grant two calls per  day 
  835.                           of  1:30  duration  each and unlimited downloads.  
  836.                           Another example, [1:30,2/500], shows a 500k daily 
  837.                           download limit in effect.  
  838.  
  839.              hh:mm ...... The  Daily Time Limit.  This field is a sub-field 
  840.                           within the [...] of the Call  Time  Limit  field.  
  841.                           It  cannot  be  specified  without  the Call Time 
  842.                           Limit and the Daily Call  Limit  being  specified 
  843.                           also.  Example:  [1:00,5,2:00]  would  grant five 
  844.                           calls per day,  each of up to 1 hour each,  but a 
  845.                           maximum of 2 hours per day total usage.  
  846.  
  847.              path ....... The  upload pathname.  This specifies where files 
  848.                           uploaded by a particular class of user are to  be 
  849.                           stored.  
  850.  
  851.              pwd ........ The Password.  As said above, the password may be 
  852.                           from  1-20  characters  in  length  and  must  be 
  853.                           unique.  If this line is a class entry the  "pwd" 
  854.                           field  should  contain  the word CLASS in capital 
  855.                           letters.  
  856.  
  857.              auth ....... The Authorizations  given  to  this  entry.  They 
  858.                           come from the following list: 
  859.  
  860.                      UP : Upload authorized.
  861.                      DN : Download authorized.
  862.                      PR : Private mail authorized.
  863.                      KL : Allow  the  killing of messages,  the same as the 
  864.                           Sysop.  
  865.                      MS : Allows message reading.
  866.                      MV : Allows  message  moving.  Message  may  be  moved 
  867.                           between message bases.  
  868.                      CC : Allows usage  of  the  carbon  copy  feature  for 
  869.                           messages.  
  870.                      RC : Require netmail credit for all netmail messages - 
  871.                           normally local messages don't require credit.  
  872.                      BP : Bypass logon.  This allows callers to bypass  all 
  873.                           the steps between logon and the main menu.  
  874.                      BO : With  the BP option,  causes only bulletins to be 
  875.                           bypassed during the logon procedure.  
  876.                      SY : Sysop priveledges authorized.
  877.                      CH : Manual directory change is authorized (in absence 
  878.                           of the GTDIR.BBS file).  
  879.                      CB : CB Simulator authorized.
  880.                      SH : Shell to DOS is authorized.
  881.                      DR : Use of DOORS is authorized.
  882.                      FA : Allows  file  attach  when  using   the   netmail 
  883.  
  884.  
  885.                                    - 15 -
  886.  
  887.  
  888.                           programs.  
  889.                      FR : Allows   file  request  when  using  the  netmail 
  890.                           programs.  
  891.                      NL : Disable the (L)ist directory command at the  main 
  892.                           menu.  
  893.                      NN : No name uploads.  Callers with this authorization 
  894.                           will   not   have  their  name  recorded  in  the 
  895.                           FILES.BBS, when they upload a file.  
  896.                      NE : Disable the (E)nter message command.
  897.                      NP : Disable the sysop (P)age command.
  898.                      NX : No expert mode.  Callers with this  authorization 
  899.                           will not have access to the e(X)pert mode.  
  900.                      PW : The caller is authorized to change his  password.  
  901.                           But   before   he   can   change   any   personal 
  902.                           information,  the caller  must  match  his  phone 
  903.                           number to verify his identity.  
  904.                      TB : The Time Bank is authorized.
  905.  
  906.                      These  authorizations  are listed seperated by commas, 
  907.                      following the "pwd" field.  See  examples  below.  The 
  908.                      CH  authorization  is  a "do nothing" authorization in 
  909.                      most cases, because most systems use a GTDIR.BBS file.  
  910.                      On these systems the CH option may be used as a way to 
  911.                      grant  no  authorization,  because  a  total  lack  of 
  912.                      authorization  yields  the  default authorization set: 
  913.                      DN,UP,PR,MS.  
  914.      
  915.                      Time Bank Setup
  916.                      ---------------
  917.                      The Time Bank, TB, authorization has a rather complex 
  918.                      format, for example:
  919.  
  920. ;        TB field labels                        uk uf dk df me mr mk  dl  wl
  921. E1 [1:00,5/300,2:00,C:\UP] CLASS UP,DN,DR,MS,TB=01/02/03/04/03/00/05:060/060
  922.  
  923.                      Note the TB= entry at the  end  of  the  authorization 
  924.                      list.  Each field is of fixed length, 0's required, as 
  925.                      shown.  No field may be omitted from the list, however 
  926.                      they  may  be  zeroed  out,  if not wanted.  The field 
  927.                      definitions are: 
  928.                         
  929.                          uk = Upload  time  bank  credit per 100k uploaded.  
  930.                               If possible,  the credited amount is  rounded 
  931.                               and   pro-rata   for   lesser  uploads.   For 
  932.                               example,  if uk = 2,  then a 50k upload would 
  933.                               earn a credit of 1.  
  934.  
  935.                          uf = Upload time bank credit per file uploaded.
  936.  
  937.                          dk = Download   time   bank   deduction  per  100k 
  938.                               downloaded.  As is done with the 'uk'  field, 
  939.                               this   deduction   is   pro-rata  for  lesser 
  940.                               downloads.  
  941.  
  942.  
  943.  
  944.                                    - 16 -
  945.  
  946.  
  947.                          df = Download  time  bank   deduction   per   file 
  948.                               downloaded.  
  949.  
  950.                          me = Message  Entry  time  bank credit per message 
  951.                               entered.  
  952.  
  953.                          mr = Time bank credit per message read.
  954.  
  955.                          mk = Time bank deduction per message deleted.
  956.  
  957.                          dl = Daily limit on time bank deposits.
  958.  
  959.                          wl = Daily limit on time bank withdrawals.
  960.  
  961.                      Time may be withdrawn from the Time Bank via the  main 
  962.                      menu  command  [TB].  Time  may  also  be converted to 
  963.                      netmail credits, if desired.  
  964.  
  965.                      Carbon Copy Messages
  966.                      --------------------
  967.                      The  carbon  copy  feature  allows us to send the same 
  968.                      message to a group of people.  The list of  names  may 
  969.                      appear  in  the  message itself,  or be contained in a 
  970.                      separate file.  This feature  is  controlled  via  dot 
  971.                      commands.  Like other dot commands,  a '.' is put into 
  972.                      column  1  of  any  line  of  the  message,   followed 
  973.                      immediately  by  the  appropriate  command.  The  most 
  974.                      familiar commands are:  .CS,  .GL,  .GM and .RR (which 
  975.                      should  be  familiar  to all netmail users).  Now here 
  976.                      are some new ones to control the carbon copy feature: 
  977.  
  978.                          .CC ..... Carbon Copy.  For example:
  979.  
  980.                                          .cc John Doe,64/2
  981.                                          .cc Frank White
  982.  
  983.                                    The first .CC would send a  carbon  copy 
  984.                                    of  the  current  message to John Doe on 
  985.                                    net/node  064/002   (via   the   netmail 
  986.                                    system, of course). 
  987.  
  988.                                    The  2nd  example  would simply create a 
  989.                                    carbon  copy  for  Frank  White  on  the 
  990.                                    current   BBS   where  you  entered  the 
  991.                                    message.  
  992.  
  993.                          .BC ..... Blank Carbon.  This command works like 
  994.                                    the carbon  copy  command,  except  that 
  995.                                    this  carbon  is  not  included  in  the 
  996.                                    distribution list (normally shown at the 
  997.                                    bottom of the message).  This  is  neat, 
  998.                                    if you want to send a carbon to someone, 
  999.                                    but   not   alert   the  others  on  the 
  1000.                                    distribution list.  
  1001.  
  1002.  
  1003.                                    - 17 -
  1004.  
  1005.  
  1006.  
  1007.                      Pre-canned distribution lists are available for use by 
  1008.                      folks that have  a  repeating  distribution.  The  '@' 
  1009.                      syntax  is used with the .CC command to call up a pre-
  1010.                      written distribution... as follows: 
  1011.  
  1012.                          .cc @c:\gt\foo.bar
  1013.  
  1014.                      The full pathname should be specified for this  entry, 
  1015.                      however,  GT POWER  will look in the GTPATH directory, 
  1016.                      if  no  pathname  is  given.   The  contents  of   the 
  1017.                      distribution file uses the same syntax as given above, 
  1018.                      the  .CC and .BC lines written as if they had been put 
  1019.                      in  the  regular  message.   For  example,   the  file 
  1020.                      C:\GT\FOO.BAR might contain: 
  1021.  
  1022.                          .cc John Fisher,22/1
  1023.                          .cc Rob Roesch,64/3
  1024.                          .cc Reb Gambrell,33/16
  1025.                          .cc Stephen Ricciardelli,9/400
  1026.  
  1027.                      Also,  it  is  possible,  in a pre-canned distribution 
  1028.                      list,  to blank out the names and replace them with  a 
  1029.                      comment  (when  they  appear in the message).  This is 
  1030.                      done  by  making  the  1st  line   of   a   pre-canned 
  1031.                      distribution the .LA command, as follows: 
  1032.  
  1033.                          .la Beta Distributors
  1034.                          .cc John Fisher,22/1
  1035.                          .cc Rob Roesch,64/3
  1036.                          .cc Reb Gambrell,33/16
  1037.                          .cc Stephen Ricciardelli,9/400
  1038.  
  1039.                      Notice,  the  .LA  command on the first line.  The .LA 
  1040.                      command can only appear in  pre-canned  distributions, 
  1041.                      and  if  it  appears,  it must be the 1st entry in the 
  1042.                      file.  LA is short for LABEL,  which  can  be  spelled 
  1043.                      out,  if desired.  If an .LA entry is at the beginning 
  1044.                      of a pre-canned distribution file,  then no names  are 
  1045.                      shown  on the carbon copy list in the message,  rather 
  1046.                      it would simply show: 
  1047.  
  1048.                          Carbon Copy: Whatever the LA command says goes here
  1049.  
  1050.                      Using the example above:
  1051.          
  1052.                          Carbon Copy: Beta Distributors
  1053.  
  1054.                      Note,  it is possible to mix  netmail  responses  with 
  1055.                      local  conference  responses.  For  example,  this  is 
  1056.                      okay: 
  1057.  
  1058.                          .cc Stephen Ricciardelli,9/400
  1059.                          .cc John Dokes
  1060.  
  1061.  
  1062.                                    - 18 -
  1063.  
  1064.  
  1065.                          .cc Perry Alexander,32/1
  1066.  
  1067.                      The  1st  and  3rd  carbons  would  be  delivered  via 
  1068.                      netmail,  while  the  2nd  would  be  placed  into the 
  1069.                      currently selected conference.  
  1070.  
  1071.              1st-Name Last-Name Phone-Number
  1072.                      These three fields are present when it is  desired  to 
  1073.                      allow  the  caller "callback" priveledges.  In effect, 
  1074.                      if the caller's name matches the name listed here  and 
  1075.                      he  gives the correct password,  the system will offer 
  1076.                      to call him at the  listed  number.  This  allows  the 
  1077.                      host  to  assume the cost of the phone charges for the 
  1078.                      session.  The caller must be prepared  to  accept  the 
  1079.                      call, that is his modem must be in "auto-answer" mode.  
  1080.                      Send  "ATS0=1|" to most Hayes type modems to set auto-
  1081.                      answer mode.  The "|" represents a "carriage  return".  
  1082.                      If  the  conditions  are  met GT POWER will return the 
  1083.                      call within 15 seconds,  and will retry 3 times before 
  1084.                      giving-up  hope of establishing the connection.  NOTE: 
  1085.                      the password assigned  here  for  the  callback,  must 
  1086.                      *not*  be  the same as the caller's personal password, 
  1087.                      i.e. the callback password *MUST* be unique.  
  1088.  
  1089.               NOTE:  It is possible to append a  single  character  to  the 
  1090.                      level  indicator.  Thus  "A1"  would be a valid level.  
  1091.                      This extra character is  used  to  identify  a  custom 
  1092.                      bulletin  file  for this caller.  This extra character 
  1093.                      is optional,  but if present MUST BE a character  that 
  1094.                      is  legal within a file name.  Read about BULLET files 
  1095.                      below.
  1096.  
  1097.                 Examples:
  1098.                      A  [2:00,100/1000,5:00,c:\goodies] MASTER  SY
  1099.                      B1 [1:00] FRIEND  DN,PR
  1100.                      B1 [1:00,4/500,2:00,c:\up] CLASS DN,UP,PR
  1101.                      C  [1:30] JOGGER  DN,UP,PR,DR MARY ADAMS 1-213-555-1234
  1102.                      A  [2:00,10,4:00] CLASS SY
  1103.                      C2 [2:00,3/250,3:00] CLASS DN,UP,PR,DR
  1104.  
  1105.                      In  version 12.10 of GT POWER,  personalized passwords 
  1106.                      were introduced.  When  a  caller  gets  his  personal 
  1107.                      password  it is stored in the USER.CTL file,  with the 
  1108.                      other user information.  The access level assigned  to 
  1109.                      the  password  used  by  the  caller on the first call 
  1110.                      (before a personal password was assigned) will be  the 
  1111.                      access  level assigned to the caller until changed via 
  1112.                      the SYSOP program.  To provide  a  time  limit,  daily 
  1113.                      call  limit,  and  bullet#,  a  cross reference of the 
  1114.                      access level stored in the users  record  in  USER.CTL 
  1115.                      file  and  the GTPASSWD.BBS file is required.  This is 
  1116.                      accomplished by placing CLASS cards  for  each  access 
  1117.                      level  your  system  uses  into the GTPASSWD.BBS file.  
  1118.                      The format of the CLASS card is the same as  a  normal
  1119.  
  1120.  
  1121.                                    - 19 -
  1122.  
  1123.  
  1124.                      password  entry,  except the word CLASS must appear in 
  1125.                      uppercase letters.  In  addition,  the  CLASS  entries 
  1126.                      cannot  be used to provide callbacks,  normal password 
  1127.                      entries must be provided for that  purpose.  Here  are 
  1128.                      some example CLASS entries: 
  1129.  
  1130.                 Examples:
  1131.                      A1  [2:00,5/500,3:00]  CLASS  DN,UP,PR,DR,SH,MS
  1132.                      B3  [1:30,2/250,2:00]  CLASS  DN,PR,MS
  1133.                      K2  [:45,1/100,:45]    CLASS  DN,UP,PR,DR,MS
  1134.  
  1135.                      The first CLASS entry establishes a class for  callers 
  1136.                      with  an  'A'  access  level,  grants  them 2 hours of 
  1137.                      session time,  a daily call limit of 5 calls,  a daily 
  1138.                      download limit of 500k,  3 hours of time per day,  and 
  1139.                      gives  them  the  authorizations:   Download,  Upload, 
  1140.                      Private  mail,  use  DOORS,  Shell  to  DOS,  and read 
  1141.                      messages.  The other entries grant lesser time amounts 
  1142.                      to the 'B' and 'K' classes.  The 'B'  class  is  given 
  1143.                      Download,    Private    mail,    and    Read   message 
  1144.                      authorizations.  The  'K'  class  is  given  Download, 
  1145.                      Upload,  Private  mail,  use  DOORS,  and message read 
  1146.                      authorizations.  Note:  if you neglect to setup  CLASS 
  1147.                      entries  then  once  your  callers  have been assigned 
  1148.                      their   own   personal   passwords,    and   this   is 
  1149.                      automatically  done  by GT POWER,  then they will have 
  1150.                      unlimited time access  to  your  system,  the  default 
  1151.                      authorizations, and they will not be given a bullet#.  
  1152.  
  1153.                      It   is   possible   to   add  comment  lines  to  the 
  1154.                      GTPASSWD.BBS file.  Any line with a  ';'  in  the  1st 
  1155.                      column  is  a  comment  entry,  and will be ignored by 
  1156.                      GT POWER.  
  1157.  
  1158.                +----------------------------------------------------------+
  1159.                |                                                          |
  1160.                |      Remember to give callers the MS authorization       |
  1161.                |      so they can "read messages".  And setup a CLASS     |
  1162.                |      entry for every different access level in use.      |
  1163.                |                                                          |
  1164.                +----------------------------------------------------------+
  1165.  
  1166.      GTBULLET.BBS    This  file  is  displayed  for the caller after he/she 
  1167.                      completes logon.  It is useful to leave notes here for 
  1168.                      expected callers.  
  1169.  
  1170.      BULLETx.BBS     The "x" may be any character that can be a legal  part 
  1171.                      of   a   filename.   This  character  must  match  the 
  1172.                      character which is found after the level indicator  in 
  1173.                      the password file,  to enable custom bulletin files to
  1174.                      be displayed for callers.  For example:  if a caller's 
  1175.                      level  was  "BZ",  then the program would search for a 
  1176.                      file named BULLETZ.BBS to display whenever the  caller 
  1177.                      logged onto the program.  
  1178.  
  1179.  
  1180.                                    - 20 -
  1181.  
  1182.  
  1183.  
  1184.               NOTE:  Custom  bulletin  files  are  OPTIONAL.  If you do not 
  1185.                      wish to use them, simply use single letters for access 
  1186.                      level indicators.  
  1187.  
  1188.      GTMENU.BBS      This file is displayed for callers as the  main  menu.  
  1189.                      It may be suppressed by a caller by selecting e(X)pert 
  1190.                      mode.  
  1191.  
  1192.      GTHELP.BBS      This file is displayed when the caller  requests  help 
  1193.                      from the main menu.  
  1194.  
  1195.      GTBYE.BBS       This  file  is  displayed  for the caller when he logs 
  1196.                      off, i.e.  selects the (G)oodbye command from the main 
  1197.                      menu.  
  1198.  
  1199.      GTBYEx.BBS      This is  a  custom  bye  file.  The  'x'  may  be  any 
  1200.                      character  that can be a legal part of a filename.  It 
  1201.                      comes  from  the  GTPASSWD.BBS  file,  as  the  letter 
  1202.                      following   the  level  indicator.   Most  commonly  a 
  1203.                      number.  See custom BULLETx.BBS files above.  
  1204.  
  1205.      GTUSER.BBS      This file is created whenever a call  comes  into  the 
  1206.                      system.  It  will contain the access level and name of 
  1207.                      the current caller, or if no call is in progress,  the 
  1208.                      previous caller to the system.  The file contains just 
  1209.                      this 1 line of text.  The exact format is: 
  1210.  
  1211.      L 1st-Name Last-Name auth baud ANSI-opt last-on limit event time
  1212.  
  1213.                      The line is free format with spaces delimiting fields.  
  1214.                      The  'L' field is the access level of the caller.  The 
  1215.                      "Last-Name" field will consist of a single  character, 
  1216.                      a  ';',  if  the caller has only 1 name.  The ';' will 
  1217.                      act as a  placeholder  in  that  case,  so  that  DOOR 
  1218.                      programs  will have an easier time unpacking this data 
  1219.                      on  the  line.  The  'auth'  field  will  contain  the 
  1220.                      authorizations given this caller from the GTPASSWD.BBS 
  1221.                      file when he logged onto the system.  The 'baud' field 
  1222.                      will  two  baud rates seperated by a ':',  for example 
  1223.                      19200:2400.  The first baud rate is the DTE rate,  the 
  1224.                      second  baud  rate is the DCE rate.  The split rate is 
  1225.                      necessary for those using high speed  modems.  If  the 
  1226.                      current  session  is  a  local  sysop logon,  then the 
  1227.                      'baud' field will contain the word LOCAL, if the sysop 
  1228.                      is  logged-on.   The  'ANSI-opt'  field  will  contain 
  1229.                      'NOANSI' if the caller doesn't want ANSI graphics,  or 
  1230.                      'ANSI' if he does want  the  graphics.  The  'last-on' 
  1231.                      field  contains  the  date  the  user  last called the 
  1232.                      system.  The 'limit' field contains the remaining time 
  1233.                      the caller has left for the current call.  The 'event' 
  1234.                      field contains the time remaining until the next event 
  1235.                      is scheduled.  The 'time' field contains  the  current 
  1236.                      time in 'xx:xx' format.  The time remaining fields are 
  1237.  
  1238.  
  1239.                                    - 21 -
  1240.  
  1241.  
  1242.                      integer showing time left in minutes.  
  1243.  
  1244.                      The  purpose  of  this information is to supply needed 
  1245.                      control information  to  external  programs  that  run 
  1246.                      either in the Shell to DOS or DOOR environment.  
  1247.  
  1248.      GTDIR.BBS       This  file  contains a list of directories that may be 
  1249.                      accessed by callers.  There are three types  of  lines 
  1250.                      in  this  file:  the  actual directory lines,  comment 
  1251.                      lines and group header lines.  The comment  lines  are 
  1252.                      displayed  to  the caller when he asks to see the list 
  1253.                      of directories.  The list displayed will contain  only 
  1254.                      those  directories the caller is authorized to access.  
  1255.                      The formats: 
  1256.  
  1257.                 Group Header Lines:
  1258.                      Begin with a '.'  in  the  1st  column.  The  detailed 
  1259.                      format  is  explained under GTMDIR.BBS.  GTDIR.BBS and 
  1260.                      GTMDIR.BBS have very similar formats,  so rather  than 
  1261.                      explain it twice...  
  1262.  
  1263.                      Groups  are  optional,  both  in the GTDIR.BBS and the 
  1264.                      GTMDIR.BBS.  
  1265.                     
  1266.                 Comment Lines:
  1267.                      Contain a blank in the 1st column,  the  remainder  of 
  1268.                      the line is displayed for the caller.  
  1269.  
  1270.                 Directory Lines:
  1271.                      Column  1  - access Level.  The minimum level required 
  1272.                      to access the directory.  If this column  contains  an 
  1273.                      '='  then  the  actual  line is shifted to the right 1 
  1274.                      column and the '=' acts to reserve the  directory  for 
  1275.                      the  indicated  access  level  - which would now be in 
  1276.                      column 2. (See example.) 
  1277.  
  1278.                      One or more blank columns follows the level,  then the 
  1279.                      complete DOS pathname of the directory,  including all 
  1280.                      drive and PATH information.  One or more blank columns 
  1281.                      follows the directory name,  then a description of the 
  1282.                      directory   is  given.   When  a  caller  selects  the 
  1283.                      (C)hange directory command,  the list of choices  will 
  1284.                      display  the descriptions you provide here,  so try to 
  1285.                      be helpful.  
  1286.  
  1287.                      CD-ROM support is specified on  the  directory  lines.  
  1288.                      The  first  step is to specify a full pathname for the 
  1289.                      FILES.BBS,  as one can't  put  a  FILES.BBS  onto  the 
  1290.                      CD÷ROM itself.  Here is an example:
  1291.  
  1292.                      Z  F:\DIR6,,C:\GT\FILES\D6.BBS,CD  Some description
  1293.                      E  G:\DIR22,,C:\GT\FILES\D22.BBS   Another description
  1294.  
  1295.                      Compared  to  normal entries in the GTDIR.BBS you will 
  1296.  
  1297.  
  1298.                                    - 22 -
  1299.  
  1300.  
  1301.                      note that the pathname for the directory  is  followed 
  1302.                      by  two commas and the pathname for a BBS file,  which 
  1303.                      is optionally followed by ',CD'.  The two  commas  are 
  1304.                      required...  don't ask why just yet, I plan to stick a 
  1305.                      new field in there later on.  Following the two commas 
  1306.                      is the full pathname of the FILES.BBS (must  be  on  a 
  1307.                      writable  disk  drive).  The  ',CD'  is optional,  and 
  1308.                      causes GT POWER to skip this directory when the caller 
  1309.                      asks for new file (I)nquiry (kinda senseless to search 
  1310.                      a CD÷ROM for new files, heh?).  
  1311.  
  1312.                      The FILES.BBS for an upload directory is always  found 
  1313.                      in  the directory with the uploaded files.  The CD-ROM 
  1314.                      support  cannot  be  used  to  redirect   the   upload 
  1315.                      descriptions to a different location.  
  1316.  
  1317.                      Note: to  newcomers,   a  FILES.BBS  is  a  file  that 
  1318.                            contains the descriptions of the files available 
  1319.                            for  download.  It's  construction  is described 
  1320.                            elsewhere in this document.  
  1321.  
  1322.                 Examples:
  1323.  
  1324.                      .Z  GENERAL   General File Board
  1325.                        This is a comment.  (Since column 1 is blank)
  1326.                      A  G:\DIR9,,C:\F\DIR9.BBS,CD The description goes here.
  1327.                      =B C:\LOTUS\DATA This is for 'B' level callers only.
  1328.                      C  A:\ The description again goes here.
  1329.  
  1330.                      The first line in the example  above,  shows  a  group 
  1331.                      header  line.  This  example  shows three directories, 
  1332.                      one with an 'A' access level (on a CD-ROM drive),  one 
  1333.                      with a 'C' access level.  These are the minimum levels 
  1334.                      that  callers  must  have  to "see" these directories.  
  1335.                      The '=B' directory may be  accessed  only  by  callers 
  1336.                      with the 'B' access level.  
  1337.  
  1338.      GTUDIR.BBS      This file provides caller selectable  multiple  upload 
  1339.                      areas.  Of course,  this is an optional feature,  just 
  1340.                      omit this file if you wish all uploads to go into  the 
  1341.                      normal    upload   directories   (specified   in   the 
  1342.                      GTPASSWD.BBS file,  on a CLASS basis).  The format  of 
  1343.                      GTUDIR.BBS  is  similar  to the GTDIR.BBS,  here is an 
  1344.                      example: 
  1345.  
  1346.                               Upload Directories
  1347.                               ------------------
  1348.                           z   C:\GTBBS\UP    Misc Upload Directory
  1349.                           z   C:\GTBBS\PROG  Programmer's Uploads
  1350.                           =E  D:\SPECIAL     Alpha Tester's Uploads
  1351.                           A   C:\PRIVATE     Private Uploads
  1352.  
  1353.                      The 3rd upload area, with the '=E' designation,  would 
  1354.                      only  be  available  to callers with access level 'E'.  
  1355.  
  1356.  
  1357.                                    - 23 -
  1358.  
  1359.  
  1360.                      The first two areas would be available to all callers, 
  1361.                      with 'z' as the required  minimum  access  level.  The 
  1362.                      4th  directory  would  be  private (assuming that most 
  1363.                      callers have access lower  than  'A'  <GRIN>),  access 
  1364.                      given only to those with 'A' access level or above.  
  1365.  
  1366.                      If  the  GTUDIR.BBS is present,  GT POWER will ask the 
  1367.                      caller where to place  the  upload,  just  before  the 
  1368.                      upload  begins.  The  areas that the caller has access 
  1369.                      to will be listed for the caller,  so that the  caller 
  1370.                      can make a choice.  The selected upload directory will 
  1371.                      override  the  upload path from the CLASS entry in the 
  1372.                      GTPASSWD.BBS file (in fact,  if you use the GTUDIR.BBS 
  1373.                      file,  the  upload  path  in  the GTPASSWD.BBS file is 
  1374.                      redundant).  
  1375.  
  1376.      GTLDIR.BBS      This file allows the Sysop to construct  a  menu  that 
  1377.                      will  be  presented  to  callers immediately after the 
  1378.                      GTSYSID.BBS screen and  prior  to  the  ANSI  graphics 
  1379.                      question.  This  menu  can  be  used  to  swap  around 
  1380.                      different  language  files.  The  GTLDIR.BBS  has  the 
  1381.                      following format: 
  1382.  
  1383.                          Starting in column 1,  the name of the batch  file 
  1384.                          to  be  executed  if  the  related  menu option is 
  1385.                          selected.  Followed by at least 1 blank,  then the 
  1386.                          text  to appear on the menu.  Any line that begins 
  1387.                          with  a  blank  is  displayed  "as  is"  for   the 
  1388.                          caller...   explanatory  text.   Comments  may  be 
  1389.                          included by placing a  ';'  in  column  1  of  the 
  1390.                          comment  line  (comments  aren't displayed for the 
  1391.                          caller).  For example: 
  1392.  
  1393.                                ;  This is a comment
  1394.  
  1395.                                   Language Selection Menu
  1396.  
  1397.                                ;  Language 1, the most likely choice
  1398.                                GTLANG_1   Language Number 1
  1399.                                GTLANG_2   Language Number 2
  1400.                                GTLANG_3   Language Number 3
  1401.                                ;  The End
  1402.  
  1403.                      This would appear on-screen for the caller like this: 
  1404.  
  1405.                                Language Selection Menu
  1406.  
  1407.                                1.  Language Number 1
  1408.                                2.  Language Number 2
  1409.                                3.  Language Number 3
  1410.  
  1411.                                Enter Language Selection:
  1412.  
  1413.                      The   batch   files,    GTLANG_1.BAT,    GTLANG_2.BAT, 
  1414.  
  1415.  
  1416.                                    - 24 -
  1417.  
  1418.  
  1419.                      GTLANG_3.BAT  should  contain  simple  copy  commands.  
  1420.                      Copy  commands  that  move  into place BBS/CBS screens 
  1421.                      matching the selected language  entry.  Nothing  heavy 
  1422.                      duty should be done in these batch runs,  as there may 
  1423.                      be limited memory  available.  The  example  showed  3 
  1424.                      choices,  but  there  can  be  more,  however the menu 
  1425.                      should not be more than 1 screen full,  otherwise  the 
  1426.                      crashmail runs won't be able to work properly.  
  1427.  
  1428.                      After  the language batch file has run,  GT POWER will 
  1429.                      display a new  screen,  GTANSI.BBS,  for  the  caller.  
  1430.                      This  screen  will only be displayed if the GTLDIR.BBS 
  1431.                      is installed and operational.  It should contain  some 
  1432.                      lead-in  explanation  for  the  ANSI graphics question 
  1433.                      (that formerly would  have  been  in  the  GTSYSID.BBS 
  1434.                      screen).  
  1435.                      
  1436.      GTDDIR.BBS      This  file controls access to the GT DOOR system.  Its
  1437.                      function  is  much  like   GTDIR.BBS   is   for   file 
  1438.                      directories.  It  serves  as  a way to add security to 
  1439.                      doors,  document them and  pass  parameters  to  them.  
  1440.                      Each  door must have an entry in this file,  there are 
  1441.                      no comment lines in this file.  Each line in this file 
  1442.                      follows the this syntax: 
  1443.  
  1444.                  L  [comment_here_with_no_spaces]  (Prompt message here:)
  1445.  
  1446.                      The () indicate which fields are optional and need not 
  1447.                      be included in the file.  
  1448.  
  1449.                      As with the  GTDIR.BBS  file,  the  'L'  controls  the 
  1450.                      minimum  access  level required to open the door.  The 
  1451.                      [comment] is not optional, and must be enclosed within 
  1452.                      [...] and no blanks are allowed.  If a parameter  must 
  1453.                      be passed to the DOOR,  then the optional prompt field 
  1454.                      must be added.  The answer given to this prompt by the 
  1455.                      caller will be passed to  the  DOOR  as  command  line 
  1456.                      argument %3.  
  1457.  
  1458.                      Examples:
  1459.                          B  [this-is-door-1]
  1460.                          Z  [this-is-door-2]  Enter filename:
  1461.                          S  [this-is-door-3]
  1462.  
  1463.                      In the example above, the 2nd door has a prompt listed 
  1464.                      that  indicates  that this door requires a filename be 
  1465.                      passed.  This could be for example to implement an ZIP 
  1466.                      view door,  where the name  of  the  ZIP  file  to  be 
  1467.                      processed  might  need  to  be supplied.  The caller's 
  1468.                      response will be passed as command line argument %3 to 
  1469.                      the GTDOOR2.BAT file in this case.  
  1470.  
  1471.                +----------------------------------------------------------+
  1472.                |                                                          |
  1473.  
  1474.  
  1475.                                    - 25 -
  1476.  
  1477.  
  1478.                |     Please note, the order of the lines in this file     |
  1479.                |     must be 1st door on 1st line, 2nd door on 2nd line,  |
  1480.                |     etc.  The lines must be in 1, 2, 3... order.         |
  1481.                |                                                          |
  1482.                +----------------------------------------------------------+
  1483.  
  1484.      GTBMENU.BBS     This file is the bulletin menu file.  It  should  list 
  1485.                      the  numbered  bulletin  files.  The numbered bulletin 
  1486.                      files should be located in the "Default File Section", 
  1487.                      and their file names should simply be 1, 2, etc.  This 
  1488.                      menu file will be displayed as users logon your system 
  1489.                      and besides the numeric bulletins,  two alpha  options 
  1490.                      should  be  listed:  (L)ist  logon  bullets and (Q)uit 
  1491.                      bulletin menu.  An example of a GTBMENU.BBS file: 
  1492.  
  1493.                               1.  Bullet #1 description here.
  1494.                               2.  Bullet #2 description here.
  1495.                               .
  1496.                               .  etc.
  1497.                               .
  1498.                               L)ist logon bullets
  1499.                               Q)uit bulletin menu.
  1500.  
  1501.                      It  is  possible that these bulletin files can contain 
  1502.                      ANSI graphics.  If so, they should be named with a CBS 
  1503.                      extension.  For example: 
  1504.  
  1505.                            1          Bullet #1, no extension, no graphics.
  1506.                            1.CBS      Bullet  #1,   with  .CBS   extension, 
  1507.                                       contains graphics.  
  1508.                            2          Bullet #2, no extension, no graphics.
  1509.                            2.CBS      Bullet #2,    with  .CBS   extension,
  1510.                                       contains graphics.
  1511.  
  1512.                      Remember:  These bullet files must be placed into  the 
  1513.                                 "Default  File  Section",  as defined under 
  1514.                                 the Alt-I pathname setup.  And CBS versions 
  1515.                                 of  bulletins  cannot  occur  without   the 
  1516.                                 standard "no graphics" version.  
  1517.  
  1518.                      Starting with GT 16.00,  these bulletin files  may  be 
  1519.                      nested.  When  nesting  bulletins,  we will talk about
  1520.                      bulletin numbers with a decimal point embedded within, 
  1521.                      i.e. 1.0.0 or 2.1.0.  Each successive level of nesting 
  1522.                      requires  another  decimal  be  added  to  the  bullet 
  1523.                      number,  to a maximum of 5 levels deep.  When equating 
  1524.                      the bulletin numbers to file names,  the  periods  are 
  1525.                      first  eliminated,   for  example  1.0.0  would  equal 
  1526.                      filename 100,  and 2.1.0  would  equal  filename  210.  
  1527.                      These  files  would  be  located  in the "Default File 
  1528.                      Section",  as outlined  above.  If  we  consider  this 
  1529.                      situation for a bit,  we see that there must be a sub-
  1530.                      menu structure applied to these bulletins, in order to 
  1531.                      get them properly nested.  For example,  we might have 
  1532.  
  1533.  
  1534.                                    - 26 -
  1535.  
  1536.  
  1537.                      the following in the top level file, GTBMENU.BBS: 
  1538.  
  1539.                              1.0  General Bulletins
  1540.                              2.0  Game Bulletins
  1541.  
  1542.                      The  1.0  would  refer  to the file 10 in the "Default 
  1543.                      File Section" and the 2.0 would refer to the  file  20 
  1544.                      in  the  "Default File Section".  Each of these files, 
  1545.                      10 and 20,  would be sub-menus,  which  then  actually 
  1546.                      referred  to the actual bulletins.  For example,  file 
  1547.                      10 might look like this:
  1548.  
  1549.                      ;BMENU
  1550.  
  1551.                              1.1  Rules of the board
  1552.                              1.2  How to get more time
  1553.                              1.3  How to get higher access
  1554.  
  1555.                      The  line  beginning  with  ';BMENU'  must be the very 
  1556.                      first line of file 10, this signals GT POWER that this 
  1557.                      file is not actually  a  bottom  level  bulletin,  but 
  1558.                      instead  is another bullet menu.  Files 11,  12 and 13 
  1559.                      are the actual bulletin files  (and  therefore,  would 
  1560.                      not contain the ';BMENU' entry).  
  1561.  
  1562.                      Because  these  bullet  menus  can  be  nested up to 5 
  1563.                      levels deep,  some new letter commands  are  available 
  1564.                      for usage in navigation.  As follows: 
  1565.                
  1566.                          M    Return to main bulletin menu (GTBMENU.BBS).
  1567.                          P    Pop back to the previous bullet menu.
  1568.  
  1569.      
  1570.      GTMDIR.BBS      This  file  controls  the  multiple message bases that 
  1571.                      GT POWER can support.  The format of this file is  the 
  1572.                      same as the format for the GTDIR.BBS file, except that 
  1573.                      you  have  1  additional option for column 1,  you may 
  1574.                      place a '*' in column 1 of an line in  this  file  and 
  1575.                      then  that  message area will become a 'by application 
  1576.                      only' message base.  The caller applies  for  entrance 
  1577.                      by  trying  to  select the message area via the (A)rea 
  1578.                      change command.  GT POWER will inform the caller  that 
  1579.                      application  has  been  accepted  and  the  Sysop must 
  1580.                      approve.  The users  name  will  be  placed  into  the 
  1581.                      USER_MSG.CTL  file  associated  with the message base, 
  1582.                      but the BAN bit  will  be  set,  the  Sysop  must  use 
  1583.                      SYSOP.EXE  to reset the BAN bit so that the caller can 
  1584.                      be admitted.  
  1585.  
  1586.                      When setting up, the Sysop should insure that all sub-
  1587.                      directories listed in GTMDIR.BBS exist,  but  GT POWER 
  1588.                      will  automatically  provide all the control files and 
  1589.                      message directories, as needed.  
  1590.  
  1591.  
  1592.  
  1593.                                    - 27 -
  1594.  
  1595.  
  1596.                      All message areas must have an  entry  in  this  file, 
  1597.                      including  the  Sysop  Message Base.  The main default 
  1598.                      message area must be open to all callers and must  use 
  1599.                      the  same  pathname  as  the  message base pathname in 
  1600.                      GT POWER's configuration  file.  The  GTMDIR.BBS  file 
  1601.                      must  be  located with the other BBS files,  either in 
  1602.                      the GTPATH directory or the BBS/CBS directory.  
  1603.  
  1604.            +--------------------------------------------------------------+
  1605.            |                                                              |
  1606.            |    The pathname portion of the lines in the GTMDIR.BBS       |
  1607.            |    file may be prefixed with either '^', '~', '<', '$'       |
  1608.            |    or '#'.                                                   |
  1609.            |                                                              |
  1610.            |       ^ ... Designates a message area that can support       |
  1611.            |             public messages only.                            |
  1612.            |       ~ ... Designates a message area that is used as a      |
  1613.            |             netmail area (see netmail docs).                 |
  1614.            |       < ... Designates a message area that is Read-Only.     |
  1615.            |             Only the Sysop can enter messages.               |
  1616.            |       $ ... Designates a message area that can support       |
  1617.            |             private messages only.                           |
  1618.            |       # ... The netmail reply mechanism is denied on a       |
  1619.            |             message base level.                              |
  1620.            |                                                              |
  1621.            +--------------------------------------------------------------+
  1622.  
  1623.                      Examples:
  1624.  
  1625.                           Z   ^C:\GTBBS\OPEN       Public Message Base
  1626.                           E    C:\GTBBS\GENERAL    General Message Base
  1627.                           F    C:\GTBBS\SPECIAL    Special Message Base
  1628.                           Q  #^C:\GTBBS\ECHO       An Echomail Conference
  1629.                           Z   ~C:\GTBBS\PUBLIC     Public Netmail Area
  1630.  
  1631.                      Please notice the entry for the  Echomail  Conference, 
  1632.                      it  demonstrates  that  echoes should have only public 
  1633.                      messages,  the '^' modifier assures this,  and the '#' 
  1634.                      modifier  disables the netmail return feature (netmail 
  1635.                      returns  are  only  available  to  callers  that  have 
  1636.                      netmail  credits  --  use  SYSOP.EXE  to issue netmail 
  1637.                      credits).   Personally,  I  like  the  netmail  return 
  1638.                      feature,  but  some Sysops don't,  so a means has been 
  1639.                      provided to disable it on a selective basis.  
  1640.  
  1641.  
  1642.                      Message  bases  and   file   areas,   GTMDIR.BBS   and 
  1643.                      GTDIR.BBS,  can be split into logically grouped areas.  
  1644.                      Groups are  totally  optional...  you  don't  have  to 
  1645.                      introduce   groups   into  either  the  GTMDIR.BBS  or 
  1646.                      GTDIR.BBS.  The beginning of a group is denoted by the 
  1647.                      Group Header, like this: 
  1648.  
  1649.                           .Z     GENERAL      General Board
  1650.  
  1651.  
  1652.                                    - 28 -
  1653.  
  1654.  
  1655.                           Z    #^C:\GT        General Message Base
  1656.                           Z     ~C:\MAIL      Netmail Area
  1657.                           .=D    NETWORK      GT Network Sysop Board
  1658.                           Z     ^C:\SYS       GT Network Sysops Echo
  1659.                           Z     ^D:\NODE_ECO  The Nodelist Echo
  1660.  
  1661.                       In the example above,  there are two groups.  A group 
  1662.                       header begins  with  a  '.'  in  column  1.  The  2nd 
  1663.                       character  is  usually  an  access level (the minimum 
  1664.                       required to access  the  group).  But  note  the  2nd 
  1665.                       group header begins '.=D',  this denotes a group that 
  1666.                       is available to the 'D' access level only.  After the 
  1667.                       access level,  there is at least one blank,  then the 
  1668.                       group name,  'GENERAL' and 'NETWORK' in this example.  
  1669.                       After the group name is the menu description for  the 
  1670.                       group.  The lines following each group header are the 
  1671.                       usual entries for the message bases or file areas (in 
  1672.                       the case of GTDIR.BBS).  
  1673.  
  1674.                       The  group  name  must  be  unique  in  the  first  8 
  1675.                       characters,  but may be up to 30 characters in  total 
  1676.                       length.  
  1677.  
  1678.      GTDOORS.BBS     This file is displayed for the caller when he  selects 
  1679.                      the  (O)pen  DOORS option from the main menu.  It is a 
  1680.                      pure text file,  which should contain your DOOR  menu.  
  1681.                      Each DOOR is assigned a number,  1-999,  and should be 
  1682.                      listed on this menu by the number needed to select the 
  1683.                      door.  
  1684.  
  1685.                      It is possible to have sub-menus,  which work  off  of 
  1686.                      the  GTDOORS.BBS menu.  If the GTDOORS.BBS file looked 
  1687.                      like this: 
  1688.  
  1689.                                    Main Door Menu
  1690.                                    --------------
  1691.                                    A.  Game Doors
  1692.                                    B.  Database Doors
  1693.                                    C.  Utility Doors
  1694.  
  1695.                      Then,   if  the  caller  selects  'A',   the  sub-menu 
  1696.                      GTDOOR÷A.BBS would shown.  Or  if  'B'  were  selected 
  1697.                      then  GTDOOR÷B.BBS  would  be  shown.  Then whenever a 
  1698.                      numeric entry is made,  the caller would be  put  into 
  1699.                      the  selected  door.  A  simple  carriage return would 
  1700.                      take  the  caller  back  to  the   main   door   menu, 
  1701.                      GTDOORS.BBS.  
  1702.  
  1703.      GTDOORnn.BAT    These are the DOOR files themselves.  These are  batch 
  1704.      GTDORnnn.BAT    files,  much  like  the  Shell to DOS batch file,  but 
  1705.                      instead of executing another copy of  COMMAND.COM,  it 
  1706.                      executes your DOOR program.  The mechanism of the DOOR 
  1707.                      uses  the  CTTY  commands  at the start and end of the 
  1708.                      file.  The CTTY redirects the console to the COM  port 
  1709.  
  1710.  
  1711.                                    - 29 -
  1712.  
  1713.  
  1714.                      at the start of the DOOR file, and back to the console 
  1715.                      at  the  end.  Sample DOOR files are included with the 
  1716.                      package.  Here is a short example: 
  1717.  
  1718.                                     %1 com%2
  1719.                                     edlin %3
  1720.                                     %1 con
  1721.  
  1722.                      The  %1  will become "ctty" or "rem",  and the %2 will 
  1723.                      become the port number,  through substitution by  DOS.  
  1724.                      The  "REM" substitution is used when the DOOR is being 
  1725.                      run locally by the Sysop to check it out.  A DOOR that 
  1726.                      works in the local mode may  not  work  for  a  remote 
  1727.                      caller,  because  the DOOR program may not use the DOS 
  1728.                      functions to perform I/O through the console.  
  1729.  
  1730.                      Remember  that the 3rd command line argument is passed 
  1731.                      from the GT POWER host  to  the  DOOR  containing  the 
  1732.                      response  from  the caller to a prompt you have placed 
  1733.                      into the GTDDIR.BBS file.  In this case, it would have 
  1734.                      asked the caller which file he wanted to edit.  If the 
  1735.                      door doesn't require a 3rd  parameter,  GT POWER  will 
  1736.                      pass  the  DCE baud rate as the 3rd parameter.  If the 
  1737.                      door does  require  a  3rd  parameter,  then  it  will 
  1738.                      override  and  replace  the baud rate.  This should be 
  1739.                      handy for doors that do file  transfers  via  external 
  1740.                      protocol drivers.  
  1741.  
  1742.                      Please  note  the  two  forms  of  the   door   names.  
  1743.                      GTDOORnn.BAT  is  used  for door numbers 1 through 99.  
  1744.                      For  doors  numbered  from  100   through   999,   use 
  1745.                      GTDORnnn.BAT.  For example: 
  1746.  
  1747.                                Door #5 ..... GTDOOR5.BAT
  1748.                                Door #45 .... GTDOOR45.BAT
  1749.                                Door #125 ... GTDOR125.BAT
  1750.                                Door #999 ... GTDOR999.BAT
  1751.  
  1752.      ANSWERn.BBS     This file contains the answers supplied by the callers 
  1753.                      to  the 'n' questionaire,  that you have stored in the 
  1754.                      QUESTn.BBS  file.  The  format  of  this  file  is  as 
  1755.                      follows:  each  answer given by a user is written on a 
  1756.                      separate line to this file, the answers are grouped by 
  1757.                      placing the users name,  from logon,  onto  the  first 
  1758.                      line  of  the  group,  enclosed  within  <<  ...   >>, 
  1759.                      following this each answer appears on a separate  line 
  1760.                      and  each group is terminated with a line containing a 
  1761.                      single period.  Here is an example: 
  1762.  
  1763.                                << Paul Meiners >>
  1764.                                9350 Country Creek #30
  1765.                                Houston, TX 77036
  1766.                                713-772-2090
  1767.                                .
  1768.  
  1769.  
  1770.                                    - 30 -
  1771.  
  1772.  
  1773.                                << Susie Meiners >>
  1774.                                1245 Sunnyside Dr.
  1775.                                Houston, TX 77081
  1776.                                713-894-3465
  1777.                                .
  1778.  
  1779.                      The   example  shown  above  contains  two  groups  of 
  1780.                      answers.  As  GT POWER  accumulates  answers  it  will 
  1781.                      continue  to  append them to the end of this file.  If 
  1782.                      this file does not exist,  GT POWER  will  create  it.  
  1783.                      The Sysop should avoid editing this file,  because any 
  1784.                      attempt to do so  may  render  GT POWER  incapable  of 
  1785.                      adding  answers  to  it  (if  the editor adds a Ctrl-Z 
  1786.                      character to the end of the file).  
  1787.  
  1788.      QUESTn.BBS      This  file  contains  the  questionaire for callers to 
  1789.                      fill out.  This feature is optional.  The file  is  in 
  1790.                      template  format,  using  the  [------]  construct  to 
  1791.                      indicate where GT should gather answers to  questions.  
  1792.                      For example: 
  1793.  
  1794.                                                   [------------]
  1795.                               Enter Phone Number:
  1796.  
  1797.                      Would  direct GT to collect the phone number,  showing 
  1798.                      GT where to collect the answer and the  maximum  width 
  1799.                      answer  to  accept.  Each  answer  can  be  up  to  80 
  1800.                      characters long and there may be up  to  50  questions 
  1801.                      per questionaire.  
  1802.  
  1803.                      After  having filled out the questionaire,  the caller 
  1804.                      will be asked if he wishes his answers to be recorded.  
  1805.                      If he indicates NO,  the  GT POWER  will  discard  the 
  1806.                      answers.  
  1807.  
  1808.                      The questionaire is optional, and if the user tries to 
  1809.                      fill out a questionaire that cannot be found, GT POWER 
  1810.                      will   indicate   to  the  caller  that  there  is  no 
  1811.                      questionaire currently available.  
  1812.  
  1813.                      There can be up to 99 different questionnaires for the 
  1814.                      caller.  The GTQMENU.BBS file is displayed with a list 
  1815.                      of all available questionnaires.  
  1816.  
  1817.                      Before  a  new caller reaches the main menu,  GT POWER 
  1818.                      will   automatically   present    the    New    Caller 
  1819.                      Questionnaire.  It is questionnaire 0, QUEST0.BBS.  No 
  1820.                      pre-questionnaire  will be displayed,  the caller will 
  1821.                      just be forced to answer  the  questionnaire.  If  the 
  1822.                      caller  tries  to  drop carrier or otherwise avoid the 
  1823.                      new caller questionnaire,  then  GT POWER  will  force 
  1824.                      them to answer it on their next call.  Of course,  the 
  1825.                      new caller  questionnaire  is  optional  (simply  omit 
  1826.                      QUEST0.BBS and all will be as it was before).  
  1827.  
  1828.  
  1829.                                    - 31 -
  1830.  
  1831.  
  1832.  
  1833.                      Questionnaires are programmable.  Commands must  start 
  1834.                      in column 1 of any line that contains a command.  Line 
  1835.                      labels  can  be  added  to the questionnaire,  so that 
  1836.                      branch commands have some way to locate where to goto. 
  1837.                      A line label begins with a ':' in column  1,  followed 
  1838.                      by an 8 character name, for example: 
  1839.  
  1840.                           :label
  1841.  
  1842.                      The following commands are supported: 
  1843.  
  1844.                      [%DT] ............... Date/time stamp.
  1845.  
  1846.                           Records the current date/time in the answer file.  
  1847.  
  1848.                      [%ABORT] ............ Abort the questionnaire.
  1849.  
  1850.                           Stop  the  questions and return the caller to the 
  1851.                           main menu.  
  1852.  
  1853.                      [%JN,pathname] ...... Join caller to message base.
  1854.  
  1855.                           Join the caller to the message base pointed to by 
  1856.                           'pathname'.  
  1857.  
  1858.                      [%TB,label] ......... Test for blanks in answer.
  1859.  
  1860.                           Test  the  answer  to  the  previous question for 
  1861.                           blanks,  if the answer is blank,  then branch  to 
  1862.                           the specified line label.  
  1863.  
  1864.                      [%TA,label] ......... Test for ASCII in answer.
  1865.  
  1866.                           Test  the answer to the previous question for all 
  1867.                           ASCII data.  If all characters are  normal  ASCII 
  1868.                           (32-125  decimal),  then  branch to the specified 
  1869.                           line label.  
  1870.  
  1871.                      [%SV] ............... Force questionnaire to be saved.
  1872.              
  1873.                           This  command should be placed near the beginning 
  1874.                           of the questionnaire, to insure it is "in effect" 
  1875.                           before the caller decides to drop carrier <GRIN>.  
  1876.                           Once it has taken effect,  the questionnaire WILL 
  1877.                           BE saved, unless the computer crashes.  
  1878.                        
  1879.                      [%MO] ............... Execute a "More?" prompt.
  1880.  
  1881.                           This command causes a "More?" prompt to be given
  1882.                           to the caller.
  1883.  
  1884.                      [%TL,A-E=label] ..... Test access level.
  1885.                      [%TL,L=label]
  1886.  
  1887.  
  1888.                                    - 32 -
  1889.  
  1890.  
  1891.  
  1892.                           If a caller has the indicated access level,  then 
  1893.                           branch to the  specified  line  label.  As  shown 
  1894.                           above,  the test can be for a range of levels, or 
  1895.                           for a particular access level.  
  1896.  
  1897.  
  1898.                      [%IF,X,xxx=label] ... Test answer for value.
  1899.                      [%IF,X,x=label]
  1900.                      [%IF,X,A-C=label]
  1901.                      [%IF,N,10=label]
  1902.                      [%IF,N,20-30=label]
  1903.  
  1904.                           This command allows the Sysop to test the  answer 
  1905.                           to  the  previous  question.  The  entry  can  be 
  1906.                           tested as a number or  a  string  of  characters.  
  1907.                           The  'X'  param indicates a string test should be 
  1908.                           performed.  The 'N'  param  indicates  a  numeric 
  1909.                           test.  The  test can be for individual numbers or 
  1910.                           characters, or it can be a range.  For example: 
  1911.  
  1912.                              [%IF,X,Y=okay]
  1913.                                   Test 1st character of answer for a 'Y'.
  1914.                              [%IF,N,10-15=right]
  1915.                                   Test  if the number was between 10 and 15 
  1916.                                   inclusive.  
  1917.                              [%IF,X,MAGIC=got_it]
  1918.                                   Test if the word was the word 'MAGIC'.
  1919.  
  1920.                           If the test evaluates to be true,  then branch to 
  1921.                           the specified line label.  
  1922.  
  1923.                      [%GO,label] ......... Goto label.
  1924.  
  1925.                            Unconditionally  branch  to  the  specified line 
  1926.                            label.  
  1927.  
  1928.                      [%XX,reason] ........ Disconnect caller, log reason.
  1929.  
  1930.                            Disconnect the caller from the  BBS  immediately 
  1931.                            and write the 'reason' to the GT.LOG file.  
  1932.  
  1933.                      [%XD,nnn] ........... Adjust the caller's expiration
  1934.                                            date.
  1935.  
  1936.                            Where 'nnn' is the number of days from today  to 
  1937.                            set the expiration date.  For example, 365 would 
  1938.                            set the expiration date to a year from today.  
  1939.  
  1940.                      [%LV,x] ............. Adjust caller's access level.
  1941.  
  1942.                            Change the caller's access level to the value of 
  1943.                            'x', where 'x' can be any legal access level.  
  1944.  
  1945.  
  1946.  
  1947.                                    - 33 -
  1948.  
  1949.  
  1950.                      [%LP,n,label] ....... Loop back to label.
  1951.  
  1952.                            This command allows the previous question to  be 
  1953.                            repeated.  This  is  very  handy for cases where 
  1954.                            the  caller's  response  appears  incorrect   or 
  1955.                            unacceptable.  The  'n' specifies how many times 
  1956.                            the question is to be asked --- the [%LP command 
  1957.                            will fall through after asking the question  'n' 
  1958.                            times.  A good time to [%XX the caller <GRIN>.  
  1959.  
  1960.                      Answer labels
  1961.                      -------------
  1962.                      Prior to version 17.06,  one of the  biggest  problems 
  1963.                      that  I've  had  with questionnaires is that there has 
  1964.                      been no easy way to identify the answers, without some 
  1965.                      way to cross-reference with the questionnaire.  Answer 
  1966.                      labels can be added to the questionnaire by making  an 
  1967.                      addition to the prompt line.  For example: 
  1968.  
  1969.                                                [---] 
  1970.                             Are you are sysop?  
  1971.  
  1972.                      This  question  has  no  answer  label.  The answer is 
  1973.                      recorded in the ANSWERn.BBS file  as  entered  by  the 
  1974.                      caller.  But now, let's add an answer label: 
  1975.  
  1976.                                                [---]
  1977.                             Are you are sysop?        [%SYSOP]
  1978.  
  1979.                      Now,  the  caller's  answer  will be recorded with the 
  1980.                      label "SYSOP".  The answer file might  look  something 
  1981.                      like this: 
  1982.  
  1983.                             AGE     : 12
  1984.                             SYSOP   : no
  1985.                             BBS_PHON: 602-897-9549
  1986.                             VOICE_PH: 602-897-9557
  1987.  
  1988.                      The "answer label" is recorded in the first 8 columns, 
  1989.                      the  caller's  answers  are  recorded in column 11 and 
  1990.                      afterwards.  
  1991.  
  1992.                      The "answer label" should not  be  confused  with  the 
  1993.                      "line  label"  discussed above.  The line label is not 
  1994.                      recorded in the answer file,  but is used  to  control 
  1995.                      the branching within a questionnaire program.  
  1996.  
  1997.          Sample Questionnaire
  1998.          --------------------
  1999.          [%DT]
  2000.  
  2001.                                NEW USER QUESTIONNAIRE
  2002.  
  2003.          :ASK_AGE
  2004.  
  2005.  
  2006.                                    - 34 -
  2007.  
  2008.  
  2009.  
  2010.                                       [---]
  2011.                     How old are you?                [%AGE]
  2012.          [%IF,N,1-18=MINOR]
  2013.          [%IF,N,19-70=ADULT]
  2014.  
  2015.                     Really!   That is too old!!
  2016.  
  2017.          [%LP,3,ASK_AGE]
  2018.          [%GO,DUMP]
  2019.          :ADULT
  2020.  
  2021.                     You are an adult. 
  2022.  
  2023.          [%GO,ASK_SYS]
  2024.          :MINOR
  2025.  
  2026.                     You are a minor.
  2027.  
  2028.          :ASK_SYS
  2029.  
  2030.                                      [---]
  2031.                     Are you a sysop?                [%SYSOP]
  2032.          [%IF,X,Y=SYSOP]
  2033.          [%IF,X,N=REGULAR]
  2034.          [%LP,3,ASK_SYS]
  2035.          :DUMP
  2036.  
  2037.                     Sorry!  You gotta go...
  2038.  
  2039.          [%XX,DUMB BELL SYNDROME]
  2040.          [%GO,FINAL]
  2041.          :REGULAR
  2042.  
  2043.                     You aren't a sysop.
  2044.  
  2045.          [%GO,FINAL]
  2046.          :SYSOP
  2047.  
  2048.                     You are a sysop!
  2049.  
  2050.          [%LV,A]
  2051.          :FINAL
  2052.          ---------------------------
  2053.          End of Sample Questionnaire
  2054.      
  2055.      
  2056.      PQUESTn.BBS     This file is  displayed  for  the  caller  immediately 
  2057.                      after   he  selects  the  questionaire  he  wishes  to 
  2058.                      complete  from  the  questionnaire  menu.   It  should 
  2059.                      explain  to  the  caller  the  basic  purpose  of  the 
  2060.                      questionaire and allow him to consider if he wishes to 
  2061.                      continue to fill  out  the  questionaire.  Immediately 
  2062.                      after this file is displayed,  the caller will receive 
  2063.  
  2064.  
  2065.                                    - 35 -
  2066.  
  2067.  
  2068.                      a prompt, asking if he wishes to continue and fill out 
  2069.                      the questionaire.  
  2070.  
  2071.                      The PQUESTn.BBS file is optional.
  2072.  
  2073.      GTQMENU.BBS     This file is listed for the caller when he selects the 
  2074.                      (Q)uestionnaire option from the main  menu.  It  is  a 
  2075.                      menu  file that should contain a list (in text format) 
  2076.                      for the user to choose which questionnaire  he  wishes 
  2077.                      to complete.  For example: 
  2078.  
  2079.                           1.  Order form for GT POWER.
  2080.                           2.  Order form for Turbo CALC.
  2081.                           3.  User poll.
  2082.  
  2083.                      This  shows  only  three  options,   as  many  as   99 
  2084.                      questionnaires may be supported by the system.  
  2085.  
  2086.      PROTOCOL.BBS    This  file  contains  the  protocol  menu that will be 
  2087.                      displayed for  the  caller  if  he  initiates  a  file 
  2088.                      transfer.  It  is  provided  so  that  the  Sysop  can 
  2089.                      customize this menu to his own taste.  It is pure text 
  2090.                      format, except for the first line,  which contains the 
  2091.                      list of protocols the Sysop wishes to activate for his 
  2092.                      system.  The  format  of  this  activation  line is as 
  2093.                      follows: 
  2094.  
  2095.                                   ;XYZB1TWKMSG
  2096.  
  2097.                      Where the ";" appears in column 1 of  the  line.  Each 
  2098.                      letter activates a specific protocol.  For example: 
  2099.  
  2100.                                X ... Xmodem
  2101.                                Y ... Ymodem
  2102.                                Z ... Zmodem
  2103.                                B ... Ymodem Batch
  2104.                                1 ... 1k Telink
  2105.                                T ... Telink
  2106.                                W ... WXmodem
  2107.                                K ... Kermit
  2108.                                M ... MegaLink
  2109.                                S ... SEAlink
  2110.                                G ... Ymodem-G
  2111.  
  2112.                      By omitting the activation letter from this line,  the 
  2113.                      Sysop may  disable  the  corresponding  protocol.  For 
  2114.                      example: 
  2115.  
  2116.                                       ;XYZT
  2117.  
  2118.                      Would activate and allow on the Xmodem, Ymodem, Zmodem 
  2119.                      and  Telink  protocols.  The other protocols would not 
  2120.                      be allowed.  
  2121.  
  2122.  
  2123.  
  2124.                                    - 36 -
  2125.  
  2126.  
  2127.                      The PROTOCOL.BBS file is optional, if omitted GT POWER 
  2128.                      will display a canned protocol menu.  
  2129.  
  2130.      GT_VSCAN.BAT    This is a batch file that  should  be  setup  for  the 
  2131.                      virus  scan  of  uploads.  The  GT_VSCAN.BAT  will  be 
  2132.                      executed,  like a door,  if it exists in  the  GTPATH, 
  2133.                      after  a caller completes an upload.  The names of the 
  2134.                      uploaded files will be passed to the batch file  in  a 
  2135.                      log  file  called GT_RECV.LOG.  The format of this log 
  2136.                      file is very simple:  (a) full pathnames are used, (b) 
  2137.                      a  single  filename  per  line,  (c)  entries begin in 
  2138.                      column 1,  and (d) no other information is present  in 
  2139.                      the GT_RECV.LOG.  
  2140.  
  2141.                      GT POWER  will  not  automatically erase or create the 
  2142.                      GT_RECV.LOG,  so that it may be used in  a  cumulative 
  2143.                      manner  (so  the  virus scan can be run later -- after 
  2144.                      logoff or whenever the Sysop wishes).  To  get  things 
  2145.                      started,  the  Sysop must create an empty GT_RECV.LOG, 
  2146.                      the following DOS command works nicely: 
  2147.  
  2148.                            rem >C:\GTLOGS\GT_RECV.LOG
  2149.  
  2150.                      This creates a 0 byte  file  to  get  things  started.  
  2151.                      Once  the  log  is  created,  GT POWER will append the 
  2152.                      uploaded filenames to  the  file  after  each  upload.  
  2153.                      After    GT_VSCAN.BAT   runs,    GT POWER   does   not 
  2154.                      automatically erase the GT_RECV.LOG, so the Sysop must 
  2155.                      add the commands to GT_VSCAN.BAT  to  clear  the  file 
  2156.                      after  the  scan has been done.  Again,  the DOS 'rem' 
  2157.                      command works well: 
  2158.  
  2159.                            rem >C:\GTLOGS\GT_RECV.LOG
  2160.  
  2161.                      NOTE: the  GT_RECV.LOG must be located in the GT POWER 
  2162.                            LOG PATH (which may or may not be  the  same  as 
  2163.                            the  GTPATH).  The  LOG PATH is set by the Sysop 
  2164.                            under the Alt-I, Pathnames selection.  
  2165.  
  2166.                      If the Sysop wishes to scan the files later,  sometime 
  2167.                      after the caller has logged off, the GT_VSCAN.BAT file 
  2168.                      should  not  be  created,  instead  the virus scanning 
  2169.                      logic  should  be  placed  in  the  GTLOGOFF.BAT   (or 
  2170.                      wherever the Sysop desires), but remember to clear the 
  2171.                      GT_RECV.LOG  after  the  virus  scan  has  been  done, 
  2172.                      otherwise the GT_RECV.LOG will continue to accumulate.  
  2173.                      For example, the virus scan could be done during daily 
  2174.                      or weekly maintenance runs, because full pathnames are 
  2175.                      recorded in the GT_RECV.LOG file (as long as you don't 
  2176.                      move the files someplace else,  before the scan has  a 
  2177.                      chance to run <GRIN>).  
  2178.  
  2179.                 IMPORTANT: GT POWER   does  not  automatically  create  the 
  2180.                            GT_RECV.LOG.  The Sysop must create it to  begin 
  2181.  
  2182.  
  2183.                                    - 37 -
  2184.  
  2185.  
  2186.                            with,  using  the  DOS  'rem' command,  as shown 
  2187.                            above.   If  the  Sysop  forgets  to  do   this, 
  2188.                            GT POWER   will   not  record  anything  in  the 
  2189.                            GT_RECV.LOG!  
  2190.  
  2191.      WELCOME.BBS     Each  message  base  may  have  a  welcome screen.  If 
  2192.                      present,  it resides in the directory with the message 
  2193.                      CTL files and is displayed for the caller as he enters 
  2194.                      the message base.  It is in the nature of a conference 
  2195.                      welcome screen.  The WELCOME.BBS file is optional.  
  2196.  
  2197.      MBULLETx.BBS    Each  message  base may have bulletins associated with 
  2198.                      it.  These bulletin files will reside in the directory 
  2199.                      with the message .CTL files and will be displayed  for 
  2200.                      the   caller  after  the  WELCOME.BBS  file  has  been 
  2201.                      displayed.  The bulletin numbers are coordinated  with 
  2202.                      the  regular  bulletin  numbers  in  the main GT POWER 
  2203.                      directory, which come from the bulletin numbers on the 
  2204.                      entries in the GTPASSWD.BBS file.  
  2205.  
  2206.                      The MBULLETx.BBS files are optional.
  2207.  
  2208.      SYSOP.BBS       The  SYSOP.BBS file contains almost all of the prompts 
  2209.                      and short menus used by the host  mode.  They  may  be 
  2210.                      customized  to suit the sysop's taste.  But there is a 
  2211.                      danger in changing the file too greatly,  the  overall 
  2212.                      length  of  each  entry should not be greatly changed, 
  2213.                      and each entry is limited  to  1  line.  In  addition, 
  2214.                      when  new  GT POWER  releases  are  made,  it  may  be 
  2215.                      difficult to transfer the custom changes  to  the  new 
  2216.                      file.  
  2217.  
  2218.                      There are some special lines in  the  SYSOP.BBS  file.  
  2219.                      The  1st line of the file is the welcome to chat mode, 
  2220.                      it can be customized to let the caller know  who  they 
  2221.                      are  chatting with.  The 3rd line of the file can have 
  2222.                      the name of the sysop replace the word  'Sysop'.  This 
  2223.                      will  allow  GT POWER  to personalize messages left to 
  2224.                      the  sysop.   On  line  158,  the  minimum  length  of 
  2225.                      passwords  required  by the host mode is configurable.  
  2226.                      The minimum length may be set anywhere from 0  through 
  2227.                      9  characters.  This  is accomplished by changing line 
  2228.                      158 in SYSOP.BBS to reflect  the  desired  width.  For 
  2229.                      example: 
  2230.  
  2231.                  "Password is too short[!]  Must be [6] - [20] characters."
  2232.  
  2233.                      GT POWER scans this line looking for  the  very  first 
  2234.                      number.  In this case,  GT POWER would find the number 
  2235.                      6,  and that  would  become  the  minimum  length  for 
  2236.                      passwords.  
  2237.  
  2238.                      Near the end of the SYSOP.BBS file  are  more  special 
  2239.                      lines.   First,   the   <Alt -_>   and  <Alt =+>  time 
  2240.  
  2241.  
  2242.                                    - 38 -
  2243.  
  2244.  
  2245.                      increment can be customized.  If a caller  is  online, 
  2246.                      the  sysop  can  increment  his  time limit by a small 
  2247.                      amount, use <Alt -_> to decrease the available time or 
  2248.                      <Alt =+> to increase the available  time.  The  amount 
  2249.                      of  the  increment  is shown on a line near the end of 
  2250.                      the SYSOP.BBS file that begins like this: 
  2251.  
  2252.                           "\n\n3 min. increment
  2253.  
  2254.                      The number following the "\n\n" is the amount  of  the 
  2255.                      change.  It can be any number from 1 to 9 minutes.  
  2256.  
  2257.                      A little farther down in the SYSOP.BBS file is a line 
  2258.                      that looks like this:
  2259.  
  2260.                           ".ZIP .LZH .ARC"
  2261.  
  2262.                      This line contains the  default  extensions  that  are 
  2263.                      used  to  satisfy  download  requests.  Each extension 
  2264.                      must be separated from the  one  before  by  a  single 
  2265.                      space,  and  each  extension  must  begin  with  a '.' 
  2266.                      character.  This line can be changed or added  to,  if 
  2267.                      need  be,  but there should probably be no more than 5 
  2268.                      defaults  listed,  otherwise  system  performance  may 
  2269.                      degrade.  
  2270.  
  2271.                      Even closer to the end of the SYSOP.BBS file are two 
  2272.                      lines that look like this:
  2273.  
  2274.                           "MENU="
  2275.                           "MMENU="
  2276.  
  2277.                      These  lines may be modified to add items to the menus 
  2278.                      used in the GT POWER host  mode.  The  MENU=  line  is 
  2279.                      used  to add items to the main menu and MMENU= is used 
  2280.                      to add items to the message menu.  Each item  that  is 
  2281.                      added  must  have a two character invokation sequence.  
  2282.                      For example: 
  2283.  
  2284.                           "MENU=[ZV]viewzip;Q;Enter filename:"
  2285.  
  2286.                      'ZV' is the command selection character (i.e. what the 
  2287.                      caller will need to type  to  execute  this  command).  
  2288.                      'viewzip'  is  the name of the batch file that will be 
  2289.                      executed.   The  'Q'  is  the  minimum  access   level 
  2290.                      required  before a caller can select this menu option, 
  2291.                      and the 'Enter filename:' is a prompt  for  data  that 
  2292.                      will be passed to the batch file.  For example: 
  2293.  
  2294.                      "MENU=[ZV]viewzip;Q;Enter filename:;[MR]modread;Z"
  2295.  
  2296.                      The access level and prompt for data are optional, but 
  2297.                      they  may  not be skipped over.  That is,  if you have 
  2298.                      specified a prompt for data,  you must  also  have  an 
  2299.  
  2300.  
  2301.                                    - 39 -
  2302.  
  2303.  
  2304.                      access level specified.  
  2305.  
  2306.                      Several commands can be  added  in  the  manner  shown 
  2307.                      above  to each of these two lines in SYSOP.BBS,  MENU= 
  2308.                      and MMENU=, but one must be carefull not to extend the 
  2309.                      lines past 255 characters in length.  
  2310.  
  2311.                      The interface to the  batch  files  invoked  by  these 
  2312.                      items  is  similar  to  the command interface for door 
  2313.                      batch file.  As follows: 
  2314.  
  2315.                          Param     Description
  2316.                          -----     -----------
  2317.                            1       The CTTY or REM indicator.
  2318.                            2       The COM port number.
  2319.                            3       The prompted for data.
  2320.  
  2321.                      The last param, #3, is optional, of course.  And,  for 
  2322.                      items  on  the MMENU= list,  GT automatically adds the 
  2323.                      following four parameters: 
  2324.  
  2325.                            4       -Ppathname, where 'pathname' is the path 
  2326.                                    to the currently active message base.
  2327.                            5       The message number previously read by 
  2328.                                    the caller.
  2329.                            6       Access control switch block, where a
  2330.                                    0=false and 1=true:
  2331.                                        a. Netmail message area.
  2332.                                        b. Public message area.
  2333.                                        c. Private message area.
  2334.                                        d. Read-only message area.
  2335.                            7       Netmail credits available to this 
  2336.                                    caller.
  2337.  
  2338.                      For example:
  2339.  
  2340.                         medit CTTY 1 foobar -PC:\GT\MSGB1 103 0100 200
  2341.  
  2342.                      Where:
  2343.          
  2344.                         medit ......... The name of the batch file from the
  2345.                                            MMENU= line in SYSOP.BBS
  2346.                         CTTY .......... The caller is coming in remote
  2347.                         1 ............. on COM port #1.
  2348.                         foobar ........ Data given by caller in response to 
  2349.                                            the prompt (optional).
  2350.                         -PC:\GT\MSGB1 . The currently active message base.
  2351.                         103 ........... The previous message read by caller.
  2352.                         0100 .......... Access control switch block:
  2353.                                           0: Not netmail area.
  2354.                                           1: Public messages only.
  2355.                                           0: Not for private messages only.
  2356.                                           0: Not a read-only message base.
  2357.                         200 ........... This caller has 200 netmail credits. 
  2358.  
  2359.  
  2360.                                    - 40 -
  2361.  
  2362.  
  2363.                                      
  2364.      SCHEDULE.BBS    The  "scheduler" is code within the GT POWER host mode 
  2365.                      which allows the sysop to schedule events.  The format 
  2366.                      of the SCHEDULE.BBS file is very simple.  The file  is 
  2367.                      composed  of  lines that begin with a time or range of 
  2368.                      times,   then  the  command  to  be  executed  at  the 
  2369.                      specified  time.  The  entries  in  this  file for the 
  2370.                      schedule must be in strict ascending numerical  order.  
  2371.                      Notice  the  entry  below  for '24:50',  in GT POWER's 
  2372.                      terminology this is 50 minutes  past  midnight.  Under 
  2373.                      GT POWER you must choose whether you wish to use 24 or 
  2374.                      0  as  the  hour  after  midnight.  The  hour  between 
  2375.                      midnight and 1 a.m. is either the 24th hour or the 0th 
  2376.                      hour, in any case - remember, the schedule must appear 
  2377.                      in strict ascending numerical sequence, and one should 
  2378.                      never mix references to hour 24 and hour 0 in the same 
  2379.                      schedule.  
  2380.  
  2381.                      Examples:
  2382.  
  2383.                            03:00       copy file1 file2
  2384.                            03:30       QUIT 5
  2385.                            04:00-05:00 QUIT 6
  2386.                            06:00       maint
  2387.                            24:50       QUIT 8
  2388.  
  2389.                      Based on the above example,  at 3  a.m.  the  GT POWER 
  2390.                      host  will copy file1 to file2 (any DOS command can be 
  2391.                      executed like this).  Then at 3:30 a.m.  the  GT POWER 
  2392.                      host  will  quit execution and set an ERRORLEVEL of 5, 
  2393.                      the runstream that is  controlling  GT POWER  must  be 
  2394.                      prepared  to  deal with this ERRORLEVEL,  else nothing 
  2395.                      will be done.  Also the  user  must  insure  that  the 
  2396.                      GT POWER  host  is  restarted.  At  any time between 4 
  2397.                      a.m. and 5 a.m. the GT host will quit execution and an 
  2398.                      ERRORLEVEL of 6 -- this one is meant to  illustrate  a 
  2399.                      quit  to the netmail function,  which should always be 
  2400.                      started with a range of times,  so  that  in  case  it 
  2401.                      cannot  start  exactly  on  the  button of 4 a.m.  the 
  2402.                      GT POWER host will  start  it,  even  if  it  is  late 
  2403.                      starting.  Again  the  runstream  that  is controlling 
  2404.                      GT POWER must be prepared to deal with  the  indicated 
  2405.                      ERRORLEVEL,  6  in  this  case,  and  must restart the 
  2406.                      GT POWER host *after*  5  a.m.  Then  at  6  a.m.  the 
  2407.                      GT POWER host will execute the 'maint' batch file.  
  2408.       
  2409.                      Please  note,  it is possible that an event may be run 
  2410.                      more than once,  if it finishes the first run prior to 
  2411.                      the end time of the range.  For example, the 3rd event 
  2412.                      above is shown running 03:00-04:00,  if the first time 
  2413.                      through finishes before 5 a.m.,  then  it  will  start 
  2414.                      again  (over and over again,  until 5 a.m.  is finally 
  2415.                      reached).  So the sysop must select the range of times 
  2416.                      with care.  Wider ranges  better  insure  that  events 
  2417.  
  2418.  
  2419.                                    - 41 -
  2420.  
  2421.  
  2422.                      aren't missed, narrower ranges make it easier to avoid 
  2423.                      multiple runs of the same event.  
  2424.  
  2425.                      A  sysop  may  also  add  a  special   line   to   the 
  2426.                      SCHEDULE.BBS  file  which  will  allow  control of the 
  2427.                      (P)age  function  from  the  main  menu.   The  OFFICE 
  2428.                      command allows the sysop to specify when a (P)age will 
  2429.                      be  acceptable.  If  a  (P)age is attempted outside of 
  2430.                      the specified time range,  then  the  caller  will  be 
  2431.                      notified about the sysop's OFFICE HOURS.  
  2432.  
  2433.                      Here is the format:  OFFICE=08:00-21:00
  2434.  
  2435.                      The hours may be given in 24:00 or 00:00 notation, but 
  2436.                      again,  DO  NOT mix the two styles,  i.e.  00:00-24:00 
  2437.                      would be  INCORRECT.  But  00:00-23:59  would  be  the 
  2438.                      right  way  -  or  01:00-24:59  would also be correct.  
  2439.                      Please notice that leading  zeros  must  be  supplied. 
  2440.                      08:00  is correct,  8:00 is wrong!  No embedded spaces 
  2441.                      are allowed in  this  format.  It  must  be  as  shown 
  2442.                      above.  
  2443.  
  2444.                +----------------------------------------------------------+
  2445.                |                                                          |
  2446.                |                          NOTE                            |
  2447.                |                                                          |
  2448.                |    Five minutes prior to a external event, GT POWER      |
  2449.                |    will cease accepting calls and wait for the event     |
  2450.                |    start time.  Callers who call in the vicinity of      |
  2451.                |    an event will have their time on the system cutback   |
  2452.                |    so that the caller will be off the system before      |
  2453.                |    the event is to start.                                |
  2454.                |                                                          |
  2455.                |                                                          |
  2456.                +----------------------------------------------------------+
  2457.  
  2458.      TRASHCAN.BBS    This file will test your creativity  <GRIN>.  All  the 
  2459.                      dirty words go in here,  and then anyone, who uses one 
  2460.                      of them in their name,  will not be allowed  to  enter 
  2461.                      your system.  The words in the TRASHCAN.BBS must be in 
  2462.                      _lowercase_,  otherwise  they  won't be recognized.  A 
  2463.                      special wildcard character can  be  used  in  TRASHCAN 
  2464.                      words,  the  '?'  character can be used to match *any* 
  2465.                      character other than a blank.  The blank is treated as 
  2466.                      a delimiter between first and  last  names,  and  each 
  2467.                      name  is  checked  against  the trashcan individually.  
  2468.                      The check is only performed on  new  callers  to  your 
  2469.                      system, so it doesn't slow the regular logon.  And use 
  2470.                      of  the  trashcan is optional.  Just leave it out,  if 
  2471.                      you don't want to  use  it.  An  example  TRASHCAN.BBS 
  2472.                      file: 
  2473.  
  2474.                                       d?mn
  2475.                                       h?ll
  2476.  
  2477.  
  2478.                                    - 42 -
  2479.  
  2480.  
  2481.                                       scr?w
  2482.                                       f?ck
  2483.                                       sh?t
  2484.  
  2485.      FILES.BBS       When  you create a directory to contain files,  either 
  2486.                      for upload or download,  you should include within the 
  2487.                      directory  a  file named FILES.BBS.  It should contain 
  2488.                      the descriptions of the  files  contained  within  the 
  2489.                      directory.  When  the  caller  selects  the "F" option 
  2490.                      from the main menu,  the content of this file will  be 
  2491.                      displayed.  
  2492.  
  2493.                      The  FILES.BBS  that  is  located  in  the appropriate 
  2494.                      upload directory will be  updated  automatically  with 
  2495.                      information supplied by the uploader as follows: 
  2496.  
  2497.                          Position     Description
  2498.                          --------     -----------
  2499.                          1-12         Filename
  2500.                          13           Blank
  2501.                          14-21        File size in bytes
  2502.                          22-23        Blank
  2503.                          24-31        File upload date
  2504.                          32-33        Blank
  2505.                          34-41        File creation date
  2506.                          42           Offline indicator: '*' means offline
  2507.                          43           Blank
  2508.                          44-78        Caller who uploaded the file.
  2509.  
  2510.                      Following this header line will come up to 10 lines of 
  2511.                      description.  Each line of description will begin with 
  2512.                      a '|' as the first non-blank character (i.e. not equal 
  2513.                      to  0x20).  The  format  of  the  description  may  be 
  2514.                      changed   by  the  sysop  from  the  default  used  by 
  2515.                      GT POWER,  the only rule is that the  first  non-blank 
  2516.                      (i.e.  not  equal to 0x20) must be the '|',  otherwise 
  2517.                      GT POWER will treat the line as a header or a comment.  
  2518.  
  2519.                      A header is  a  line  that  begins  with  a  non-blank 
  2520.                      character,   i.e.   not  equal  to  0x20  (except  for 
  2521.                      description lines, detailed above).  A comment line is 
  2522.                      any other line that begins with a blank (0x20).  
  2523.  
  2524.                      NOTE: 0x20 means the character is hex 20.  A blank.  A 
  2525.                            character whose decimal ASCII value is 32.  
  2526.  
  2527.  
  2528.  
  2529.  
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.                                    - 43 -
  2538.  
  2539.  
  2540.      Host Mode Control Files and Directories
  2541.      ---------------------------------------
  2542.      During the operation of the GT POWER  host  mode,  several  files  and 
  2543.      directories   will   be  created  automatically.   The  SYSOP.EXE  and 
  2544.      DELREN.EXE program must be used to maintain these files, when the need 
  2545.      arises.  Here is an overview of the purpose of these files: 
  2546.  
  2547.      MESSAGE.CTL     This file contains  the  header  information  for  all 
  2548.                      messages   maintained  by  the  GT POWER  host.   Such 
  2549.                      information as sender name,  addressee name,  date  of 
  2550.                      entry   and  whether  or  not  the  message  has  been 
  2551.                      received, are kept here.  Each message base has one of 
  2552.                      these files associated with it.  
  2553.  
  2554.      USER_MSG.CTL    This file  contains  information  about  the  messages 
  2555.                      which  have  been read by each caller who has joined a 
  2556.                      message base.  Each message  base  has  one  of  these 
  2557.                      files associated with it.  
  2558.  
  2559.      USER_MSG.IDX    The  index  file  for  the  USER_MSG.CTL file.  Speeds 
  2560.                      access to  individual  caller  records.  Each  message 
  2561.                      base has one of these files associated with it.  
  2562.  
  2563.      USER.CTL        This  file  contains  information about the callers to 
  2564.                      your GT POWER host.  Such as their  name,  where  they 
  2565.                      are  calling  from  and  their  personal passwords and 
  2566.                      access level.  This  file  is  stored  in  the  GTPATH 
  2567.                      direcotry  (or the LAN Path,  if you are using the LAN 
  2568.                      setup).  
  2569.  
  2570.      USER.IDX        The index file for the USER.CTL  file.  Speeds  access 
  2571.                      to individual caller records.  
  2572.  
  2573.      FILES.CTL       This  file contains information about all the files on 
  2574.                      the system that are  available  for  download.  It  is 
  2575.                      built   by  the  FILES_DB.EXE  program  (the  FILES_DB 
  2576.                      program must be run to build a new FILES.CTL  whenever 
  2577.                      you  move files around on the system.  The presence of 
  2578.                      this file enables the universal download  feature  and 
  2579.                      helps   to   eliminate  duplicate  uploads  (that  is, 
  2580.                      GT POWER will lookup filenames in this database  prior 
  2581.                      to  allowing  an upload from a caller - if you already 
  2582.                      have the file,  the upload  will  not  be  allowed  to 
  2583.                      continue).  
  2584.  
  2585.      FILES.IDX       The index file for the FILES.CTL file.  Speeds  access 
  2586.                      to  individual  file  records.  Even on very large BBS 
  2587.                      systems,  access to the files database is accomplished 
  2588.                      in less than a second or two.  
  2589.  
  2590.      GTMSGS          This is a sub-directory where the text of the messages 
  2591.                      is   stored.   The   GTMSGS   sub-directory  is  built 
  2592.                      automatically by  GT POWER.  Each  message  is  stored 
  2593.                      without  header  information,  which  is stored in the 
  2594.  
  2595.  
  2596.                                    - 44 -
  2597.  
  2598.  
  2599.                      MESSAGE.CTL file.  The messages are  stored  in  files 
  2600.                      with an extension of .MES.  Each .MES file contains 10 
  2601.                      messages within it.  As follows: 
  2602.  
  2603.                          00001.MES   Contains messages  #1 through #10
  2604.                          00002.MES   Contains messages #11 through #20
  2605.                          ...etc...
  2606.  
  2607.                      The  messages  are  stored in plain ASCII text format.  
  2608.                      Each  message  begins  with  a  'start   of   message' 
  2609.                      indicator with the following format: 
  2610.  
  2611.                          Col 1 = Ctrl-X
  2612.                            2-4 = 'SOM'
  2613.                              5 = '0' through '9', depending of the relative
  2614.                                  position of the message within the file.
  2615.  
  2616.                      Within  00001.MES,  message  #2 would have a header of 
  2617.                      ^XSOM1,  where  ^X  is  the  symbol  for  Ctrl-X.   In 
  2618.                      00002.MES,  messages #12 would have a header of ^XSOM1 
  2619.                      --- the same as message #2 in 00001.MES.  This  scheme 
  2620.                      allows  for  the possibility of a "rapid" renumbering.  
  2621.                      That is,  the internal numbers in the header lines are 
  2622.                      relative,  not absolute.  Changing the name of the MES 
  2623.                      file, i.e.  from 00002.MES to 00001.MES, automatically 
  2624.                      would renumber the messages contained within.  
  2625.  
  2626.      Except for the files database (FILES.CTL and .IDX) these files will be 
  2627.      created  as  necessary  by  the  GT POWER  host.   The  SYSOP.EXE  and 
  2628.      DELREN.EXE programs will perform needed maintenance  of  these  files: 
  2629.      for  example  renumbering  the  messages,   deleting  obsolete  users, 
  2630.      providing reports and listings.  HOWEVER,  do not run SYSOP.EXE  prior 
  2631.      to establishing these files.  
  2632.  
  2633.      For  batch  usage,  DELREN.EXE  is  provided  to  delete  and renumber 
  2634.      messages - the command syntax for DELREN can be obtained by  executing 
  2635.      the program with any parameters.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.  
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  
  2655.                                    - 45 -
  2656.  
  2657.  
  2658.      Running Host Mode
  2659.      -----------------
  2660.      Once installed, the host mode is fairly self-explanatory,  but here is 
  2661.      a quick once over.  
  2662.  
  2663.      Host mode is started by pressing "ALT -".  GT POWER will automatically 
  2664.      enter  "Half duplex" mode.  This is so that anything typed on the host 
  2665.      console will echo so that it can be seen.  Then GT POWER will send the 
  2666.      Host Mode Modem Init String to the modem and wait for  a  call.  While 
  2667.      GT POWER is waiting for a call, there are 4 commands available: [Esc], 
  2668.      which  will  terminate  host mode,  carriage return,  which allows the 
  2669.      Sysop to logon to GT's host mode from  the  local  console,  [Ctrl-L], 
  2670.      which turns on the system printer for logging,  and [Ctrl-S] to load a 
  2671.      fresh copy of the schedule from disk (useful for folks  who  edit  the 
  2672.      schedule  from a 2nd window under DESQview or Windows).  Note that you 
  2673.      should have logging enabled in the GT POWER configuration,  via Alt-I, 
  2674.      the  [Ctrl-L] command merely enables the printer,  so that whatever is 
  2675.      logged will also appear  on  the  system  printer.  There  also  is  a 
  2676.      command  line option to turn on the log printer.  If you place "/p" on 
  2677.      the GT command line,  the printing of the log  will  automatically  be 
  2678.      turned on from the very start of the program.  
  2679.  
  2680.      Once GT has answered an incoming  call,  there  are  several  commands 
  2681.      available to the operator, as follows: 
  2682.  
  2683.      +--------------------------------------------------------------------+
  2684.      |                                                                    |
  2685.      |                          SYSOP COMMANDS                            |
  2686.      |                                                                    |
  2687.      |      Alt-H      List available sysop commands.                     |
  2688.      |                                                                    |
  2689.      |      Ctrl-D     List current schedule on the screen.               |
  2690.      |      Ctrl-L     Toggle log printer on/off.                         |
  2691.      |      Ctrl-N     Raise caller's access level while on-line.         |
  2692.      |      Ctrl-P     Sysop initiated chat mode.                         |
  2693.      |      Ctrl-R     Reset time limit, gives caller more time.          |
  2694.      |      Ctrl-S     Load new schedule from disk.                       |
  2695.      |      Ctrl-T     Terminate after current caller disconnects.        |
  2696.      |      Ctrl-X     Abort the caller.                                  |
  2697.      |      Ctrl-Z     Terminate chat mode.                               |
  2698.      |      Alt -_     Decrement the time available to caller.            |
  2699.      |      Alt =+     Increment the time available to caller.            |
  2700.      |                                                                    |
  2701.      +--------------------------------------------------------------------+
  2702.  
  2703.      
  2704.      Command Line Usage
  2705.      ------------------
  2706.      When you start GT POWER,  there are several command line switches that 
  2707.      are available to you: 
  2708.  
  2709.  
  2710.      name      You may indicate a script file to be executed upon  start-up 
  2711.                of GT POWER.  
  2712.  
  2713.  
  2714.                                    - 46 -
  2715.  
  2716.  
  2717.  
  2718.      /D        You may indicate whether or not you wish  to  have  GT POWER 
  2719.                drop the DTR signal to the modem when GT POWER exits back to 
  2720.                DOS.  
  2721.  
  2722.      /C        You  may indicate whether you are connected via cable to the 
  2723.                host computer.  
  2724.  
  2725.      /F        This gives GT POWER a "frontend" type interface.  If you run 
  2726.                a "frontend" program like Binkley,  you can use this command 
  2727.                line option with GT.  The  /F  takes  two  sub-params,  like 
  2728.                this: 
  2729.  
  2730.                      /F:nnnnn:m
  2731.  
  2732.                Where:
  2733.              
  2734.                      nnnnn ...... The DCE baud rate.
  2735.                      m .......... The COM port number.
  2736.  
  2737.                For example:
  2738.  
  2739.                      /F:2400:1
  2740.  
  2741.                      2400 baud on COM port 1.
  2742.  
  2743.                When  the caller logs off the system (or drops carrier),  GT 
  2744.                will execute an exit to DOS with an ERRORLEVEL 254  or  255.  
  2745.                You   should   insure   that  the  batch  file  traps  these 
  2746.                ERRORLEVELs and returns control to the  "frontend"  program.  
  2747.                See documentation that comes with the "frontend" program for 
  2748.                further details.  
  2749.  
  2750.      /K        You may initiate the capture mode from the very start of the 
  2751.                program.  It  is normally not wise to use the /K option,  or 
  2752.                capture mode,  during host  mode  operations.  Capture  mode 
  2753.                should never be left enabled when the sysop is not present.  
  2754.  
  2755.      /M        Suppress the "Check for personal mail?" function.
  2756.  
  2757.      /MN       This would allow the "Check for personal mail?" function to 
  2758.                continue, *but* would change the default prompt from [Y/n] 
  2759.                to [y/N].  
  2760.  
  2761.      /P        You may enable logging to the system printer.
  2762.  
  2763.      /PE       You may specify the pre-event wait interval, and whether you 
  2764.                want the phone to go offhook during the  wait.  By  default, 
  2765.                GT POWER uses a 5 minute pre-event wait and leaves the phone 
  2766.                onhook.  An example of this parameter is: 
  2767.                      
  2768.                                     /PE03:OFF
  2769.  
  2770.                Which  would  set the pre-event wait to 3 minutes,  and take 
  2771.  
  2772.  
  2773.                                    - 47 -
  2774.  
  2775.  
  2776.                the phone offhook during that interval.  
  2777.  
  2778.                                       /PE07
  2779.  
  2780.                This sets the pre-event wait to 7 minutes,  but  leaves  the 
  2781.                phone onhook, the default state.  
  2782.  
  2783.                NOTE: the events mentioned above are those scheduled via the 
  2784.                      SCHEDULE.BBS  file.  Please see the explanation of the 
  2785.                      schedule elsewhere in this document.  
  2786.  
  2787.      /S        This  option  will  allow  the Sysop Page to be heard during 
  2788.                quiet mode.  Normally,  nothing would be heard during  quiet 
  2789.                mode.  
  2790.  
  2791.      /Tn       This option will override the normal keyboard timeout value 
  2792.                of 10 minutes.  When this timeout occurs, GT will disconnect 
  2793.                the caller.  For example:
  2794.  
  2795.                    /T5     Lower the timeout to 5 minutes.
  2796.                    /T45    Raise the timeout to 45 minutes (my favorite).
  2797.  
  2798.      /1        You may configure the port addresses in use by  your  serial 
  2799.                port.  The  actual  port  number to be configured,  1-8,  is 
  2800.                placed  after  the  slash.  The  new  base  address  of  the 
  2801.                indicated  port  is  placed  after  the slash number with an 
  2802.                intervening blank.  The address must be given with a leading 
  2803.                $ sign and be in hex notation,  for example $3F1 would be  a 
  2804.                valid address.  Refer to your hardware documentation for the 
  2805.                correct  address  to use.  GT uses standard addresses if you 
  2806.                do not override with this option.  
  2807.  
  2808.                GT POWER  allows  you  to  also  configure the IRQ used.  To 
  2809.                specify the IRQ, simply follow the port address with a ':n', 
  2810.                where the 'n' is the new IRQ to be used.  The IRQ must be in 
  2811.                the range '0' to '15'.  Be sure that the IRQ  is  not  being 
  2812.                used  by  any other device!  IRQs above 7 are only available 
  2813.                on AT class machines (and above).  
  2814.  
  2815.      /Rn       This option applies to the GT POWER host mode.  It specifies 
  2816.                the ring number upon which  GT POWER  will  answer  incoming 
  2817.                calls.  For  example  /R3  would cause GT POWER to answer on 
  2818.                the 3rd ring.  NOTE:  that the host mode modem  init  string 
  2819.                must contain S0=0 to allow this to work properly.  
  2820.  
  2821.      /RBmm:nn  This option applies to the GT POWER host mode.  It specifies 
  2822.                that  GT  should  answer  the modem after a "ring back".  To 
  2823.                enable this to work  properly,  the  host  mode  modem  init 
  2824.                string  must  contain  S0=0.  Once  installed  properly this 
  2825.                option makes the GT POWER host mode answer the phone on  the 
  2826.                2nd  or  3rd  ring  after  a  gap  of  between 'mm' and 'nn' 
  2827.                seconds.  If the gap between rings is less than 'mm' seconds 
  2828.                or greater than 'nn' seconds,  GT POWER will not answer  the 
  2829.                phone.  This  allows  the use of an answering machine on the 
  2830.  
  2831.  
  2832.                                    - 48 -
  2833.  
  2834.  
  2835.                same phone line  as  the  computer.  The  answering  machine 
  2836.                should be programmed to answer on a later ring,  the 4th for 
  2837.                example.  The 'mm:nn' is optional,  and will default to a  9 
  2838.                to 32 second gap.  
  2839.  
  2840.                       HOST.BAT File
  2841.                       -------------
  2842.                          c:
  2843.                          cd \gt
  2844.                          set GTPATH=c:\gt  
  2845.                          GT1706 host.scr
  2846.  
  2847.                       HOST.SCR File
  2848.                       -------------
  2849.                          host
  2850.                            
  2851.      +------------------------------------------------------------------+
  2852.      |                                                                  |
  2853.      |   This listing of command line switches came from the main GT    |
  2854.      |   documentation file.  Please refer to that document for sample  |
  2855.      |   usage of these switches.                                       |
  2856.      |                                                                  |
  2857.      +------------------------------------------------------------------+
  2858.  
  2859.      Message Entry Editor
  2860.      --------------------
  2861.      While entering a message, full screen editing is possible.  The (E)dit 
  2862.      command  is  available  from  the message entry sub-menu for those who 
  2863.      prefer line editing.  But starting with version 17.00,  the caller can 
  2864.      simply  arrow  to a mistake and correct it.  The arrow keys are active 
  2865.      for this purpose anytime during the message entry process,  even  when 
  2866.      sitting  at  a  "More?"  or at the message entry sub-menu.  The [Ins], 
  2867.      [Del],  [Home] and [End] keys are programmed to help navigate within a 
  2868.      line, once positioned to the line via arrow keys: 
  2869.  
  2870.            [Ins] .... Toggles between overwrite and push right modes.
  2871.            [Del] .... Deletes the character under the cursor.
  2872.            [Home] ... Moves cursor to the start of the line.
  2873.            [End] .... Moves cursor to the end of the line.
  2874.  
  2875.      Some terminal packages may not be  able  to  take  advantage  of  this 
  2876.      feature,  as  their  special  keys  don't  send  the  necessary escape 
  2877.      sequences.  The codes that GT sends for these keys are  listed  in  an 
  2878.      appendix  to the GT1706.DOC file,  under "ANSI Emulation - Transmitted 
  2879.      Characters".  
  2880.  
  2881.      Note:  when navigating with the up and down arrows,  GT POWER will  to 
  2882.            skip  over  some  lines.  This  is  normal.  GT POWER  will  not 
  2883.            position the cursor to any line whose on  screen  image  differs 
  2884.            from  the  memory  image  that GT has of it.  Such things as TAB 
  2885.            characters and/or escape sequences  embedded  in  the  text  can 
  2886.            cause this problem.  
  2887.  
  2888.      Setting Expiration Dates For Callers
  2889.  
  2890.  
  2891.                                    - 49 -
  2892.  
  2893.  
  2894.      ------------------------------------
  2895.      Concerning expiration dates (introduced with version 17.00), the Sysop 
  2896.      can  specify  a  warning  interval.   This   is   under   Alt-I,   the 
  2897.      Miscellaneous  Options,  at  the  very bottom,  #19.  When a caller is 
  2898.      within the warning interval of the expiration date,  the  caller  will 
  2899.      receive  a  warning  that  the  expiration  date  is near and the file 
  2900.      XWARNING.BBS will be displayed for them.  
  2901.  
  2902.      When a caller's account has expired,  GT POWER will notify him of that 
  2903.      fact  and  will  display  the  file  EXPIRED.BBS.  Also  GT POWER will 
  2904.      automatically lower the caller's access level to 'z' (lowercase z)  -- 
  2905.      actually  the  expired  access level is configurable under Alt-I,  the 
  2906.      Miscellaneous Options,  #20.  It would be extremely wise if the  Sysop 
  2907.      has  a  CLASS  entry  for the expired access level in the GTPASSWD.BBS 
  2908.      file.  In the event that no CLASS entry is located, GT POWER will give 
  2909.      the caller default access (which is  almost  never  desirable).  Also, 
  2910.      the  default  message  base and file area must have low enough access, 
  2911.      otherwise  the  expired  callers  will  see   pathnames   instead   of 
  2912.      descriptions atop your main menu.  
  2913.  
  2914.      Expiration dates can be set via the SYSOP.EXE program.
  2915.  
  2916.      Using a LAN with GT
  2917.      -------------------
  2918.      Running a multi-node BBS with GT POWER is easy.  GT POWER  will  allow 
  2919.      up  to  32  nodes  on a network to share common message bases and file 
  2920.      areas.  The first thing you must do is decide on a structure for  your 
  2921.      network  BBS.  One  of  the systems must be identified as the 'server' 
  2922.      and will be referred to as "PID Zero"  in  the  following  description 
  2923.      (however,  you  can  easily have multiple servers).  The LAN Path must 
  2924.      point to a location on the server where all  the  caller  records  are 
  2925.      stored,  and  where  the "PID_FILE.BBS" is maintained automatically by 
  2926.      GT POWER.  Once you have decided on the structure of the network,  you 
  2927.      must  install  GT POWER  on  each  node  ---  part of the installation 
  2928.      process for GT POWER on a LAN node is setting the LAN parameters under 
  2929.      the Alt-I configuration.  Three pieces of information must be provided 
  2930.      for each node: 
  2931.  
  2932.  
  2933.          PID Number ... Must be a unique number between 0 and 31.
  2934.  
  2935.          PID Name ..... The name by which this node is known to the network 
  2936.                         software, each node should have a unique PID Name.  
  2937.  
  2938.          LAN Path ..... This must be the home directory for GT POWER on the 
  2939.                         network  server.  The  LAN Path  will  contain  the 
  2940.                         USER.CTL, USER.IDX and PID_FILE.BBS (at the least).  
  2941.                         These are  created  automatically.  It  is  assumed 
  2942.                         that  these  files  will  be shared among the other 
  2943.                         systems on the LAN.  
  2944.  
  2945.      The LAN Path must be specified to get file and message  sharing  fully 
  2946.      enabled.  Without a LAN Path,  GT POWER will assume that a non-sharing 
  2947.      environment is established (like a regular single node BBS).  
  2948.  
  2949.  
  2950.                                    - 50 -
  2951.  
  2952.  
  2953.  
  2954.      File sharing is implemented using the record locking facilities of DOS 
  2955.      3.1+ SHARE.EXE.  It is recommended that you give this program adequate 
  2956.      facilities  to do its job.  This command line seems to work well,  but 
  2957.      more resources may need to be allocated on busy systems: 
  2958.  
  2959.                                SHARE /F:7168 /L:70
  2960.  
  2961.      It should also be  noted,  that  some  LANs  require  your  CONFIG.SYS 
  2962.      parameters  to  be changed.  For example FCBS may need to be specified 
  2963.      on LAN servers, for example: 
  2964.      
  2965.                                    FCBS=24,12
  2966.  
  2967.      And  STACKS  are  very  important  under a LAN enviroment.  If you are 
  2968.      using DOS 3.2,  I would recommend switching to DOS 3.3.  With DOS 3.3, 
  2969.      I would recommend: 
  2970.  
  2971.                                   STACKS=62,512
  2972.  
  2973.      DOS 3.2 has some bugs that do not make it a good choice for the DOS on 
  2974.      the  LAN  server.  It has also been observed that BUFFERS are critical 
  2975.      on a LAN.  Setting BUFFERS above 40 is a sure formula for a  crash.  I 
  2976.      recommend: 
  2977.  
  2978.                                    BUFFERS=35
  2979.  
  2980.      If this response of the server becomes to slow, due to the low setting 
  2981.      of BUFFERS,  rather than raising the BUFFERS, I would suggest that you 
  2982.      obtain a LAN compatible disk cache program.  Ask your LAN manufacturer 
  2983.      to recommend one to you.  
  2984.  
  2985.      Finally,  resist the temptation to overload the directory indicated as 
  2986.      the  LAN Path.  For  example,  do  not  have the workstations use that 
  2987.      directory for  the  log  files.  This  would  result  in  chaos.  Each 
  2988.      workstation must have its own GTPATH and LOG Path.  
  2989.  
  2990.      Often  times  it is extremely handy to have a common pathname to reach 
  2991.      directories on the network.  For this reason, the DOS SUBST command is 
  2992.      very useful.  With it, you can assign a common pathname to shared disk 
  2993.      space on servers.  For example: 
  2994.  
  2995.                                    SUBST e: c:\
  2996.  
  2997.      Would allow the server to use drive E:  to make reference to 'c:\', as 
  2998.      the workstations probably do.  Thus E:  becomes a common path to drive 
  2999.      C: across the whole network.  
  3000.  
  3001.      The  CB  Simulator  is an online conferencing feature that is intended 
  3002.      for use on multi-node LAN based BBS systems  (a  NetBIOS  emulator  is 
  3003.      required).  The CB Simulator checks for the presence of NetBIOS before 
  3004.      allowing callers to get stuck in the CB mode.  
  3005.  
  3006.      Locally, when the host mode enters the CB Simulator, split screen mode 
  3007.  
  3008.  
  3009.                                    - 51 -
  3010.  
  3011.  
  3012.      is  automatically  invoked.  You  should  advise  callers  to manually 
  3013.      invoke split screen mode on their terminals -- otherwise they will not 
  3014.      see what they type (remember,  split screen is half-duplex,  the  host 
  3015.      mode  will  not  echo  the  caller's  keystrokes  during  CB Simulator 
  3016.      operations).  
  3017.  
  3018.      When using the CB Simulator,  please make sure that you have allocated 
  3019.      adequate  NCBs.  I  have  setup  the  following command for my NetBIOS 
  3020.      startup: 
  3021.  
  3022.                    lanbios irq=5 address=2 ncbs=35 sessions=15
  3023.      
  3024.      I am not sure if 35 NCBs are enough,  but it seems to work fairly well 
  3025.      on  a 3 node LAN.  On the server,  if it is not dedicated,  you should 
  3026.      insure that the server can manage sufficient simultaneous tasks  -  my 
  3027.      server  was set for 2 simultaneous tasks,  but I now have it setup for 
  3028.      5.  This does consume memory,  to be sure,  each extra  task  requires 
  3029.      considerable buffer space,  but it is required for the CB Simulator to 
  3030.      work alongside the other network tasks.  
  3031.  
  3032.      The following files must be created by the sysop, if the CB Simulator, 
  3033.      command (Z) from the main menu, is going to be used:
  3034.  
  3035.          CBWELCOM.BBS ...... Welcomes callers to the CB Simulator.
  3036.          CBHELP.BBS ........ Displayed in response to '@help' by the 
  3037.                                 caller.
  3038.          CBPAGE.BBS ........ Displayed to a caller who receives an '@page'
  3039.                                 from another caller.
  3040.          CBGREET.BBS ....... Displayed for the caller after entering his
  3041.                                 handle.  The file should be short and to
  3042.                                 the point, i.e. introduce the automatic
  3043.                                 '@who" list and tell the caller how to get
  3044.                                 help.
  3045.  
  3046.      The following commands are available to callers in the CB Simulator:
  3047.  
  3048.          @help ........ Display the CBHELP.BBS file.
  3049.          @ignore ...... Ignore further pages from other callers.
  3050.          @page ........ Invite another caller, by handle, into CB mode.
  3051.                            Ex: @page foxy
  3052.                         Where 'foxy' is the handle of the caller you are
  3053.                         paging.  The handle is obtained from the '@who'
  3054.                         list.
  3055.          @quit ........ Quit from CB Simulator to the main BBS menu.
  3056.          @tune ........ Tune the CB Simulator to channels 1 through 98.
  3057.                            Ex: @tune 5
  3058.          @who ......... Find out who else in on the system and which
  3059.                         channel, if any, they are tuned to.
  3060.          @sys ......... For sysops only.  Allows broadcast messages or
  3061.                         messages directed to specific pids.
  3062.                            Ex: @sys 5 Hello Mike!
  3063.                            Ex: @sys The system is going down in 5 minutes!
  3064.                         The first example sends a message to pid  5,  where 
  3065.                         Mike  is  logged  on.  The  second  example sends a 
  3066.  
  3067.  
  3068.                                    - 52 -
  3069.  
  3070.  
  3071.                         broadcast message,  to all pids,  telling them that 
  3072.                         the system is about to go down.  Please note,  that 
  3073.                         these pids do not have to be in the CB Simulator to 
  3074.                         get the  message.  These  messages  will  interrupt 
  3075.                         most things, except file transfers.  
  3076.  
  3077.      NOTE: A pid corresponds to a "position" or "workstation" on the LAN.
  3078.  
  3079.      The  CB  Simulator  uses  the  NetBIOS  Datagram  feature  to pass the 
  3080.      messages between pids on the LAN.  The Datagrams are sent to the group 
  3081.      name 'GT_POWER_CB_SIM" (the 16th byte  is  0x00).  GT  registers  this 
  3082.      group  name  whenever  the host mode is started under NetBIOS in a LAN 
  3083.      environment.  The Datagrams used by GT  are  of  a  fixed  format,  as 
  3084.      follows  (for  those  of  you  that  want to try their hand at NetBIOS 
  3085.      programming): 
  3086.  
  3087.      Byte Offset        Description
  3088.      -----------        -----------
  3089.           0             'S' for special messages, such as '@sys'.
  3090.                         'C' for normal CB Simulator messages.
  3091.          1-2            The channel number the message is addressed to.
  3092.                         Channels 1-98 are the normal CB channels.  Channel
  3093.                         99 is used for broadcast messages.
  3094.          3-4            The originating pid number.  This is used to keep a
  3095.                         pid from processing messages that he originates. 
  3096.                         Datagrams are received by *all* LAN stations having
  3097.                         registered the group name 'GT_POWER_CB_SIM'.
  3098.          5-6            Transaction code:
  3099.                             '00' - Normal message.  All 'C' type datagrams.
  3100.                             '01' - Who inquiry.     'S' type datagram.
  3101.                             '02' - Who reply.        "    "      "
  3102.                             '03' - Page inquiry.     "    "      "
  3103.                         The   transaction  codes  '01'  and  '02'  are  now 
  3104.                         obsolete,  since the @who command uses the PID_FILE 
  3105.                         to  get  its information.  Transaction code numbers 
  3106.                         up to '50' are reserved for  future  expansion.  It 
  3107.                         is  anticipated  that  '04' will be used for remote 
  3108.                         submission of DOS commands,  and '05' will be  used 
  3109.                         to remotely shutdown all pids.  
  3110.           7             Unused.  Reserved.
  3111.           8             ','.  Constant.
  3112.          9-16           The sender's handle.  If no handle, then the first
  3113.                         name of the sender.
  3114.           17            ','.  Constant.
  3115.         18-127          Text.  In a page transaction, this is the handle of 
  3116.                         the caller  being  paged.  In  other  transactions, 
  3117.                         this may be blank or contain a regular message.  It 
  3118.                         is  variable  length,   only  the  amount  of  data 
  3119.                         required is transmitted,  up to the maximum of  128 
  3120.                         bytes.  
  3121.  
  3122.  
  3123.  
  3124.  
  3125.  
  3126.  
  3127.                                    - 53 -
  3128.  
  3129.  
  3130.      Host Mode LOG
  3131.      -------------
  3132.      A few sections above, I suggested that logging be TRUE, while GT POWER 
  3133.      is running in Host Mode.  Here is why:  during Host  Mode  operations, 
  3134.      GT POWER  will  log  all  of  the  calls received,  who called and the 
  3135.      password used.  A record will also be kept of who tranfered each file, 
  3136.      how long it took and the efficiency of the transfer.  I  consider  the 
  3137.      gathering  of  this  information  to be critical to the operation of a 
  3138.      GT POWER Host.  
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.  
  3176.  
  3177.  
  3178.  
  3179.  
  3180.  
  3181.  
  3182.  
  3183.  
  3184.  
  3185.  
  3186.                                    - 54 -
  3187.  
  3188.  
  3189.      File Tagging
  3190.      ------------
  3191.      Files may be tagged, whenever the caller lists files, using the (F)ile 
  3192.      describe, (W)hereis,  (I)nquire or (L)ist commands.  The option to tag 
  3193.      a  file for later download is offerred via two methods:  (a) the arrow 
  3194.      keys and the carriage return (or spacebar) can be used to navigate the 
  3195.      screen and mark the desired files,  or (b) if  the  caller's  terminal 
  3196.      program  is  unable  to handle the full screen movement,  a (F)ilename 
  3197.      option is offerred to add files to the Tag List.  
  3198.  
  3199.      The edit tag list command, [ET] from the main menu, can be used to add 
  3200.      or subtract  files  from  the  tag  list.  The  caller  is  shown  the 
  3201.      estimated  download  time  for each file,  as well as for the complete 
  3202.      list.  
  3203.  
  3204.      Naturally,  if  more  than  1  file  is tagged,  the caller must use a 
  3205.      protocol capable of batch transfers (otherwise, only the first file in 
  3206.      the tag  list  will  be  transferred).  When  the  caller  starts  the 
  3207.      download,  if  he  has  too  many files tagged,  the [ET] command will 
  3208.      automatically start,  so that the caller has the opportunity to  prune 
  3209.      the list.  If the caller begins to logoff the board while files remain 
  3210.      untransferred  on  the  tag list,  a warning will be displayed and the 
  3211.      caller will be asked if he wishes to continue to logoff.  
  3212.  
  3213.      As explained above, if the caller logs off,  while untransferred files 
  3214.      remain  on  the  tag  list,  a warning will be displayed.  The warning 
  3215.      message is stored in the TAGWARN.BBS file.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.  
  3244.  
  3245.                                    - 55 -
  3246.  
  3247.  
  3248.      Binary Message Upload
  3249.      ---------------------
  3250.      It is possible for a caller to prepare a message offline and  then  to 
  3251.      upload the message to a GT POWER message base, after he logs onto your 
  3252.      board.  The  binary message upload facility has been implemented using 
  3253.      the  internal  protocols.  To  use  the  feature,  the  caller  begins 
  3254.      entering  a  message,  in  the normal manner,  but hits [Enter] on the 
  3255.      first empty line, where the upload is to begin,  then selects (U)pload 
  3256.      from  the message entry submenu.  Non-batch protocols,  such as Xmodem 
  3257.      and Ymodem are recommended for this purpose.  The host  will  not  ask 
  3258.      for a filename,  since the message is stored in a temporary file until 
  3259.      the upload is finished.  After the upload has completed,  the uploaded 
  3260.      message is tested for text and/or graphics and rejected if found to be 
  3261.      improper for inclusion in a message base.  If the message is okay,  it 
  3262.      is appended to any text that was entered prior to the upload.  
  3263.  
  3264.      The  uploaded  message  can  contain any sort of ANSI graphics and may 
  3265.      contain line lengths up to 255 characters (including the CR/LF pair at 
  3266.      the end of each line).  
  3267.  
  3268.      This procedure is a great improvement over the standard ASCII transmit 
  3269.      that has been used to upload messages,  because the  binary  protocols 
  3270.      include effective error correction procedures.  ASCII transmit suffers 
  3271.      from slowness and noisy lines.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.                                    - 56 -
  3305.  
  3306.  
  3307.      The Shell to DOS
  3308.      ----------------
  3309.      The DOS Shell allows remote callers to operate your computer remotely.  
  3310.      When the "Shell to DOS" option of the main menu is selected,  GT POWER 
  3311.      will  shell  to  the  file  GTDOOR.BAT.  This file will set up for the 
  3312.      remote shell by executing the proper  CTTY  command,  then  execute  a 
  3313.      secondary  DOS  shell  and let the user into the system.  He will have 
  3314.      the console,  so be cautious!  The caller will be instructed to  issue 
  3315.      the "EXIT" command to return to GT.  
  3316.  
  3317.      While the DOS Shell is active and the caller is  out  in  the  system, 
  3318.      GT POWER  will  not be idle.  GT POWER will act as a watchdog.  If the 
  3319.      caller should hang up while the DOS shell  is  active,  GT POWER  will 
  3320.      force  the system to reboot and will drop the DTR signal to the modem.  
  3321.      If commands to start GT POWER are placed in the AUTOEXEC.BAT file  and 
  3322.      a script is used to start Host Mode,  then GT POWER will automatically 
  3323.      recycle.  The script command to start Host Mode is simply HOST.  
  3324.  
  3325.      In order to get the DOS Shell to work,  the GT1706.EXE  or  GT1706.OVL 
  3326.      file  must  be  available  in  the  GTPATH  directory  (and the GTPATH 
  3327.      directory should  probably  be  in  the  DOS  PATH  statement  in  the 
  3328.      AUTOEXEC.BAT  file).  
  3329.  
  3330.      NOTE:  For  this process to work correctly,  the COMMAND.COM file must 
  3331.             reside in a  directory  pointed  to  by  the  PATH  environment 
  3332.             variable.  In order for this to work on a normal drive C:  hard 
  3333.             disk, "C:\" should be added to the PATH variable.  For example: 
  3334.  
  3335.                       PATH=c:\dos;c:\lotus;c:\gt;c:\
  3336.  
  3337.             This will ensure  that  the  proper  COMMAND.COM  file  can  be 
  3338.             located for execution by the GTDOOR.BAT runstream.  
  3339.  
  3340.             A problem with the DOS Shell has been reported when  using  DOS 
  3341.             2.xx.  This  is  caused  by  the  fact  that  DOS 2.xx does not 
  3342.             support full pathnames  when  requesting  the  execution  of  a 
  3343.             program.  To  work  around this problem,  if you have DOS 2.xx, 
  3344.             you should place the GTDOOR.BAT file in  some  other  directory 
  3345.             besides   the  GT POWER  home  directory.   If  GT POWER  finds 
  3346.             GTDOOR.BAT in his home directory,  then GT POWER will issue  an 
  3347.             EXEC  function with full pathname,  otherwise GT POWER will not 
  3348.             specify any pathname and will rely on  the  DOS  PATH  command.  
  3349.             The  directory where GTDOOR.BAT is stored must be pointed to by 
  3350.             the DOS PATH command in this case.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.                                    - 57 -
  3364.  
  3365.  
  3366.      Using the Shell to DOS
  3367.      ----------------------
  3368.      What  can be done,  once one is running DOS remote via a CTTY command?  
  3369.      Well,  one can't use any of the Fn keys or the other special  keys  on 
  3370.      the IBM keyboard!  One can't run any program that does direct hardware 
  3371.      control of the screen or keyboard.  All screen and keyboard input must 
  3372.      be done through DOS.  Well, then what can one do?  One can run any DOS 
  3373.      command; for example COPY, ERASE, DIR and others, including EDLIN, all 
  3374.      work  properly.  In  fact,  any  program  that  uses  the standard DOS 
  3375.      handles for input and output to the console will work.  But one  still 
  3376.      won't have F1 - F10 or the other special keys.  Well, that's not quite 
  3377.      so...if  the  Host  Mode computer is setup so that the ANSI.SYS device 
  3378.      driver is loaded via the CONFIG.SYS file.  Just put a line  like  this 
  3379.      one into the CONFIG.SYS file: 
  3380.  
  3381.                                DEVICE=ANSI.SYS
  3382.  
  3383.      Naturally,  ANSI.SYS must be located in the root directory of the boot 
  3384.      disk.  After that has been done,  reboot the computer.  ANSI.SYS  will 
  3385.      then  be  loaded.  One  can now remap the keyboard so that the special 
  3386.      keys are mapped to Ctrl keys instead.  This will enable programs to be 
  3387.      run that use these keys; for example EDLIN uses the arrow keys as well 
  3388.      as several function keys.  
  3389.  
  3390.      How does one remap keys with ANSI.SYS?  The following sequence must be 
  3391.      issued for each key that needs to be re-mapped: 
  3392.  
  3393.                             ESC [ ##;##;##;...p
  3394.  
  3395.      The  (...)  indicate that the sequence may be repeated as needed,  but 
  3396.      each sequence only remaps  one  key.  Once  a  file  containing  these 
  3397.      mapping  commands  has  been created,  they can be sent to ANSI.SYS by 
  3398.      TYPEing the file.  The "##" in the sequence above indicate  the  ASCII 
  3399.      codes  for  the  keys to be mapped.  For example,  let's map F3 to the 
  3400.      Ctrl-D key.  The ASCII codes for F3 are 0,61 and the  ASCII  code  for 
  3401.      Ctrl-D  is  4.  (Note:  the special keys have two codes - the first is 
  3402.      always 0.  These  codes  are  really  called  extended  ASCII  codes.) 
  3403.      Therefore, the proper ANSI.SYS command to remap F3 to Ctrl-D would be: 
  3404.  
  3405.                             ESC [ 4;0;61p
  3406.  
  3407.      Note:  Blanks are included for  readability  only,  the  "p"  must  be 
  3408.             lowercase,  and the symbol ESC stands for the escape character, 
  3409.             ASCII 27.  
  3410.  
  3411.  
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.  
  3418.  
  3419.  
  3420.  
  3421.  
  3422.                                    - 58 -
  3423.  
  3424.  
  3425.      Usage of Color
  3426.      --------------
  3427.      The  GT POWER  Host  mode  now  includes color built-in to the various 
  3428.      prompts and menus.  These colors can be configured.  The  colors  used 
  3429.      are  of  two  different sets.  The first set is composed of the colors 
  3430.      for the "Window foreground and background",  and the "Phone  directory 
  3431.      high lite foreground and background".  These colors should be subdued, 
  3432.      since  they  are  used  for  normal  informational type displays.  For 
  3433.      important command line and menu displays,  the program  will  use  the 
  3434.      colors designated for "Option high lite" and "Option low lite".  
  3435.  
  3436.      The user  can  customize  the  sysop  prompt  with  these  colors,  by 
  3437.      including  the  color  codes  in the SYSOP.BBS file.  Here is the code 
  3438.      scheme: 
  3439.  
  3440.           %  ...... Used to kill the meaning of the next character.
  3441.           %% ...... Used to display the % character.
  3442.           $  ...... Shift   the   pallette  to  the  "Window  foreground  / 
  3443.                     background" set.  
  3444.           &  ...... Shift the pallette to the "Option  high/low  lite"  set 
  3445.                     (the default).  
  3446.           [] ...... High lites whatever is between the [ and ].
  3447.           ~  ...... Kills the color.  Goes back to standard B&W image.
  3448.  
  3449.      For example:
  3450.  
  3451.           $ [SYSOP] John~ here.
  3452.  
  3453.      This  would  shift pallette to the "Window foreground/background" set, 
  3454.      high lite the word "SYSOP" and kill the color after the name "John".  
  3455.  
  3456.      Actually,  this scheme was only intended to add color to the SYSOP.BBS 
  3457.      file  and  other  built-in  menus  and prompts,  but some have already 
  3458.      discovered that these colors  can  be  added  to  the  GTMDIR.BBS  and 
  3459.      GTDIR.BBS files, to add color and emphasis.  
  3460.  
  3461.      Logon DOOR
  3462.      ----------
  3463.      In the GT POWER home directory,  it is possible to create a DOOR file, 
  3464.      with a special name,  that will be executed whenever a user logs  onto 
  3465.      your system.  The file is named 'GTLOGON.BAT' and it is constructed in 
  3466.      the  same  manner  as  a  normal  DOOR  batch file (shown above).  For 
  3467.      example: 
  3468.  
  3469.              GTLOGON.BAT
  3470.              -----------
  3471.                  %1 com%2
  3472.                     .
  3473.                     .    { Logon door executes here }
  3474.                  %1 con
  3475.  
  3476.      The sequence of events goes like this after a user calls your system: 
  3477.  
  3478.             1.  The GTWELCOM.BBS is displayed.
  3479.  
  3480.  
  3481.                                    - 59 -
  3482.  
  3483.  
  3484.             2.  Then any BULLETx.BBS is displayed.
  3485.             3.  Then the GTBMENU.BBS is displayed.
  3486.             4.  Then the GTLOGON.BAT is executed, if available.
  3487.  
  3488.      It  is  possible  to have a special logon door for new callers.  It is 
  3489.      named 'GTNLOGON.BAT'.  It will execute in place of the  regular  logon 
  3490.      door.  If  you want both to execute,  then you must chain from the new 
  3491.      caller logon door to the regular logon door.  
  3492.  
  3493.              GTNLOGON.BAT
  3494.              ------------
  3495.                  %1 com%2
  3496.                     .
  3497.                     .             { New user logon door executes here }
  3498.                     .
  3499.                  %1 con
  3500.                  GTLOGON          { Chain to regular logon            }
  3501.  
  3502.      The 'BPLOGON.BAT' file will be executed as a logon  door  for  callers 
  3503.      that  have  the  BP  authorization,  if  the caller answers 'y' to the 
  3504.      bypass prompt.  Please note,  if the BO authorization  is  given,  the 
  3505.      BPLOGON.BAT  will  not  execute.  In  other  words,  the 'BPLOGON.BAT' 
  3506.      replaces the 'GTLOGON.BAT', when it is skipped.  
  3507.      
  3508.      Logoff Batch File
  3509.      -----------------
  3510.      It is, also, possible to have a logoff batch file, 'GTLOGOFF.BAT',  in 
  3511.      the  GT POWER home directory.  This is not a DOOR,  but simply a batch 
  3512.      file that GT POWER will run,  if it is available,  whenever a user has 
  3513.      disconnected  from your system.  It may contain any normal DOS command 
  3514.      or other processing as required.  
  3515.  
  3516.      It can be useful for sysops that want to backup their  files  if  they 
  3517.      are using a RAM disk for things like the log file.  
  3518.  
  3519.      Please note, this is not a DOOR, CTTY is not redirected,  and that the 
  3520.      'watchdog' is not enabled during the execution of this batch file.  
  3521.  
  3522.      In addition, when you have a new caller to your system,  GT POWER will 
  3523.      run,  if available, a batch file called 'GTNLOGOF.BAT'.  Again, if you 
  3524.      wish to run both GTNLOGOF.BAT and GTLOGOF.BAT,  then you must chain to 
  3525.      the reguler logoff door (if you have one).  For example: 
  3526.  
  3527.              GTNLOGOF.BAT
  3528.              ------------
  3529.                     .            { No DOS redirection in logoff doors }
  3530.                     .
  3531.                     .            { New user logoff door executes here }
  3532.                     .
  3533.                  GTLOGOFF        { Chain to regular logoff, if overlaying }
  3534.  
  3535.  
  3536.  
  3537.  
  3538.  
  3539.  
  3540.                                    - 60 -
  3541.  
  3542.  
  3543.      APPENDIX
  3544.      --------
  3545.      Here is a handy list of extended ASCII codes:
  3546.  
  3547.                Key       Codes                 Key            Codes
  3548.                ---       -----                 ---            -----
  3549.                F1        0,59                  Right Arrow    0,77
  3550.                F2        0,60                  Left Arrow     0,75
  3551.                F3        0,61                  Up Arrow       0,72
  3552.                F4        0,62                  Down Arrow     0,80
  3553.                F5        0,63                  Home           0,71
  3554.                F6        0,64                  End            0,79
  3555.                F7        0,65                  PgUp           0,73
  3556.                F8        0,66                  PgDn           0,81
  3557.                F9        0,67                  Ins            0,82
  3558.                F10       0,68                  Del            0,83
  3559.  
  3560.      Here are some sample ANSI sequences!
  3561.  
  3562.                     Escape Codes         Meaning to ANSI.SYS
  3563.                     ------------         -------------------
  3564.                     ^[[4;0;61p           F3          -> Ctrl-D
  3565.                     ^[[5;0;62p           F4          -> Ctrl-E
  3566.                     ^[[19;0;77p          Right Arrow -> Ctrl-S
  3567.                     ^[[1;0;75p           Left Arrow  -> Ctrl-A
  3568.  
  3569.      With these kinds of mappings,  almost any program should  be  able  to 
  3570.      run,  if  it uses the DOS handles for standard input and output.  This 
  3571.      should make the "Shell to DOS" quite useful.  
  3572.  
  3573.  
  3574.  
  3575.  
  3576.  
  3577.  
  3578.  
  3579.  
  3580.  
  3581.  
  3582.  
  3583.  
  3584.  
  3585.  
  3586.  
  3587.  
  3588.  
  3589.  
  3590.  
  3591.  
  3592.  
  3593.  
  3594.  
  3595.  
  3596.  
  3597.  
  3598.  
  3599.                                    - 61 -
  3600.  
  3601.  
  3602.      Setup for Power-Loss Protected Operation
  3603.      ----------------------------------------
  3604.      It  is  quite  easy  to  prepare a set of files that will allow you to 
  3605.      bring GT POWER up into  what  I  should  like  to  call  a  Power-Loss 
  3606.      Protected Host Mode of operation.  First, however, a few concepts: 
  3607.  
  3608.      Whenever power  is  first  applied  to  your  system,  (or  reapplied 
  3609.      following  a blackout),  the system will boot your DOS into memory and 
  3610.      that, in turn,  will look for two files;  CONFIG.SYS and AUTOEXEC.BAT.  
  3611.      Finding the CONFIG.SYS, the DOS will tailor your environment according 
  3612.      to  its  contents  (such  as setting a new maximum number of files and 
  3613.      file buffers).  Finding the AUTOEXEC.BAT file will cause the system to 
  3614.      immediately execute the set of DOS instructions found therein.  
  3615.  
  3616.      GT POWER  may  be  caused  to  run  in  an unattended Host mode either 
  3617.      through GT POWER commands entered at the keyboard  (Alt-dash)  or  via 
  3618.      script.  The GT POWER command to do so in a GT POWER script is simply: 
  3619.      HOST.  
  3620.  
  3621.      The user should have a TSR called DOORMAN  loaded  if  the  'watchdog' 
  3622.      function  is  required  during  a remote shell to DOS or a remote door 
  3623.      activation.  DOORMAN will reboot the computer  in  the  event  that  a 
  3624.      caller drops carrier while is the shell or door.  
  3625.  
  3626.      Given  the  above,  to set up the system for Power-Loss_Protected Host 
  3627.      mode operation of GT POWER you must construct the following files: 
  3628.  
  3629.           Your normal AUTOEXEC.BAT
  3630.           A copy of the normal AUTOEXEC.BAT called AUTOEXEC.ORG
  3631.           A new file called AUTOEXEC.GT
  3632.           A new file called HOST.BAT
  3633.           A GT script file called HOST.SCR
  3634.  
  3635.      The  first four of these files belong in your root directory while the 
  3636.      script file should be placed in the same directory as GT POWER resides 
  3637.      (or in the Script path, if one is configured).  When you want to enter 
  3638.      the Power-Loss-Protected Host mode of GT POWER you need only type  the 
  3639.      single  word HOST from any directory.  The result will be the invoking 
  3640.      of the HOST.BAT file which,  in turn,  copies the AUTOEXEC.GT file  on 
  3641.      top  of  your  normal AUTOEXEC.BAT (so that if a reboot occurs it will 
  3642.      get control),  it then sets a default directory so that  your  private 
  3643.      directories are not accessible to callers into the system, and then it 
  3644.      invokes  GT POWER  specifying  the  name  and location of the HOST.SCR 
  3645.      script file you created.  Thus,  GT POWER will be  given  control  and 
  3646.      placed into Host mode.  Upon normal termination, GT POWER exits to DOS 
  3647.      which  returns  to  the  unexecuted  portion  of the HOST.BAT file and 
  3648.      continues by doing a copy of AUTOEXEC.ORG (a  copy  of  your  original 
  3649.      AUTOEXEC.BAT) on top of the current one and ending.  
  3650.  
  3651.      In the event of a power failure while in Host mode, or loss of carrier 
  3652.      while  in  the DOS Shell,  the AUTOEXEC.BAT file that is in place will 
  3653.      reset to the default (safe)  drive  and  reinvoke  the  Host  mode  of 
  3654.      GT POWER POWER.  
  3655.  
  3656.  
  3657.  
  3658.                                    - 62 -
  3659.  
  3660.  
  3661.      Sample Files for Power-Loss Protected Operation
  3662.      -----------------------------------------------
  3663.      AUTOEXEC.ORG:
  3664.  
  3665.           PATH=C:\DOS;C:\;C:\GT
  3666.           set GTPATH=C:\GT
  3667.  
  3668.      AUTOEXEC.GT:
  3669.  
  3670.           PATH=C:\DOS;C:\;C:\GT
  3671.           set GTPATH=C:\GT
  3672.           host
  3673.  
  3674.      HOST.BAT:
  3675.  
  3676.           c:
  3677.           cd      \
  3678.           copy    autoexec.gt autoexec.bat
  3679.           cd      \gt
  3680.           gt1706  host.scr
  3681.           cd      \
  3682.           copy    autoexec.org autoexec.bat
  3683.  
  3684.      HOST.SCR:
  3685.  
  3686.           host
  3687.  
  3688.  
  3689.  
  3690.  
  3691.  
  3692.  
  3693.  
  3694.  
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.  
  3701.  
  3702.  
  3703.  
  3704.  
  3705.  
  3706.  
  3707.  
  3708.  
  3709.  
  3710.  
  3711.  
  3712.  
  3713.  
  3714.  
  3715.  
  3716.  
  3717.                                    - 63 -
  3718.  
  3719.  
  3720.      GT POWER under DESQview(tm)
  3721.      ---------------------------
  3722.      GT POWER  runs  quite  well  as  a  task under the DESQview(tm) multi-
  3723.      tasking system.  There are a few things that should be  kept  in  mind 
  3724.      when doing so, however.  
  3725.  
  3726.      GT POWER will auto-detect DESQview,  and if you have told BIOS Video = 
  3727.      FALSE,  then GT POWER writes directly to the  DESQview  screen  buffer 
  3728.      (greatly  speeding  the  screen  update  process).  This may adversely 
  3729.      affect DESQview aware programs run in a shell of GT POWER,  since they 
  3730.      may not properly tell DESQview which portions of the screen to update.  
  3731.      If  you  run into this problem,  tell GT POWER that BIOS Video = TRUE.  
  3732.      This will cause screen updates to be slower,  but the  shell  programs 
  3733.      will work better.  
  3734.  
  3735.      GT POWER  will automatically give up unused time to DESQview,  so that 
  3736.      programs running in other windows  are  not  severely  impacted  while 
  3737.      GT POWER is idle.  
  3738.  
  3739.      Also, you will need to provide enough memory for GT POWER to run while 
  3740.      under  DESQview(tm).  If  you do not have to consider KERMIT or ZMODEM 
  3741.      then you can run GT POWER in a partition of as small as 360K  of  RAM.  
  3742.      Experimentation  has  shown  that  in  order to support ZMODEM and the 
  3743.      other protocols mentioned above you will need  to  set  the  partition 
  3744.      size to 460K.  
  3745.  
  3746.      GT POWER, as it requires rapid access to the serial port you are using 
  3747.      for communications must be the  first  task  loaded  in  DESQview(tm).  
  3748.      And,  a  performance option of DESQview(tm) (set by invoking the SETUP 
  3749.      program)  must  be  set  showing   the   existence   of   High   Speed 
  3750.      Communications.  Other  options  that  need to be set include the fact 
  3751.      that GT POWER is NOT SWAPPABLE  to  disk  and  time  slices  somewhere 
  3752.      between 3 and 6 ticks in length per partition.  
  3753.      
  3754.      Also,  it  would be best to tell DESQview not to virtualize the screen 
  3755.      output while GT POWER is active.  This  will  help  in  making  screen 
  3756.      output as rapid as possible.  
  3757.  
  3758.      (tm) DESQview is the trademark of QuarterDeck Office Systems.
  3759.  
  3760.  
  3761.                                    - THE END -
  3762.  
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.  
  3769.  
  3770.  
  3771.  
  3772.  
  3773.  
  3774.  
  3775.  
  3776.                                    - 64 -
  3777.